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INTRODUCTION 



The 1620 Simulator distributed by IBM is 
a set of four programs, plus a group of 
general subprograms used by two of them. 

The four programs which make up the 
Simulator are: 

1. SIM20, the program which contains the 
routines to simulate the 1620 

2. EDITOR, a program used to adapt SIM20 
to the particular 1620 system being 
simulated and to the System/ 360 used 
for simulation, and to create a self- 
loading version of SIM20 

3. DSKINT, a disk initialization utility 
program used to simulate 1620 systems 
with disk storage drives 

4. UPDT20, the program used to maintain 
and modify the Simulator 

The subprograms used by EDITOR and 
UPDT20 are: 

1. ABSLOD, an absolute loader used to 
load the other four programs or SIM20 
into System/360 main storage 

2. CONTPR, a control program used to 
supervise System/360 interruptions, to 
perform physical I/O operations, and 
to communicate with the 1052 Printer- 
Keyboard 

3. IOPACK an I/O support package used to 
perform logical I/O operations on 
devices for Simulator support func- 
tions 

4. INIT, an initialization program used 
to initialize CONTPR, IOPACK, and 
RELLDR 

5. RELLDR, a relocating loader used to 
load EDITOR and UPDT20 into System/360 
main storage 

The way in which these programs and 
subprograms perform the various functions 
of the Simulator is outlined in the follow- 
ing sections and is described in more 
detail in the sections devoted to the 
individual programs and subprograms . 



OVERALL LOGIC OF THE SIMULATOR 

Chart AA shows the overall logic of 
those parts of the Simulator using the 
common subprograms. This relationship, in 



conjunction with the System/360 main stor- 
age allocation, is described in the follow- 
ing section. 

SYSTEM/360 MAIN STORAGE ALLOCATION 

Figures 1 through 6 illustrate the allo- 
cation of System/360 main storage to the 
programs and subprograms which make up the 
Simulator. Each step corresponds to a 
phase of the loading or initialization 
procedure. 

Figure 1 shows the allocation of 
System/360 main storage to the components 
of EDITOR; Figure 2, to those of SIM20 when 
disks are not simulated; Figure 3, to those 
of SIM20 when disks are simulated, and the 
I/O simulation routines are permanently in 
main storage; Figure 4, to those of SIM20 
when disks are simulated, and the I/O 
simulation routines are resident on disk; 
Figure 5, to those of DSKINT; Figure 6, to 
those of UPDT20. The System/360 addresses 
given below are approximate, and give an 
idea of the amount of main storage allocat- 
ed to each component. 



EDITOR 

The System/360 main storage allocation 
for EDITOR is given in the following steps 
and follows the logic shown in Chart AA. 

Step 1 (IPL) : When the load key on the 
system control panel is pressed, the IPL 
sequence is loaded into the first bytes of 
System/360 main storage, and ABSLOD is 
loaded into an upper part of main storage. 

Step 2 (Absolute Load) : ABSLOD loads 
CONTPR, IOPACK, INIT, and RELLDR. After 
having loaded these subprograms, it sends 
the addresses of CONTPR, IOPACK, and RELLDR 
to INIT. 

Step 3 (Subprogram Initialization) : Con- 
trol is then transferred to INIT, which 
reads the DEV360, DEVSUP, and CALL control 
cards; from the information in these cards, 
it builds up the appropriate channel and 
unit control blocks and initializes CONTPR, 
IOPACK, and RELLDR. . 

Step 4 (Relocating Load) : After initiali- 
zation, control is transferred to RELLDR, 
which loads EDITOR into System/360 main 
storage. It uses IOPACK for I/O opera- 
tions, and uses certain facilities of 
CONTPR. 
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Step 1 

r t~ 

I I I 
I P I 
I L | 

L J 



*T T" 

j ABSLOD | 

I I 
I (IK) I 



Step 2 



r t t- 

|CONTPR|IOPACK| 

I I I 
| (3K) | (3K) | 
L X X- 



"T T T T T" 

| INIT I ABSLOD j | RELLDR | 



| UK) | (IK) | 
X X X- 



(5K) 



Step 3 



r t t T 

| CONTPR |IOPACK| I/O j 
I j | Control j 
j (3K) j (3K) | Blocks | 
L X X X. 



"T T T" 

| INIT j ABSLOD | 

I I I 
| UK) | (IK) | 
-X X X. 



"T T" 

| RELLDR | 

I I 
I (5K) I 



Step 4 



r t t t r 

| CONTPR j IOPACK j I/O | EDITOR j 

| I | Control | | 
| (3K) | (3K) | Blocks | (5K) | 
L X X X X. 



Unused 



— j 



Figure 1. System/360 Main Storage Allocation for EDITOR 



SIM20 

The System/360 main storage allocation 
for SIM20 depends on the version of the I/O 
simulation section used. 

No Disk Simulation 

When the 1620 installation being simu- 
lated has no disk storage drives, the 
loading procedure is as described in the 
following paragraphs and as illustrated in 
Figure 2 (see Chart AB) . 



Step 1 (IPL) ; Same as step 1 for EDITOR. 



Step 2 (Absolute Load) : ABSLOD loads a 
condensed SIM20 version of CONTPR into 
addresses 00000 through 02299; it then 
loads SIM20. CPU and console simulation 
routines are loaded into addresses 02300 
through 09699, and I/O simulation routines 
are loaded into addresses 09700 through 
10999. 



Step 1 (Same as in Figure 1) 
Step 2 

r t t t — 

I 1620 j CPU and j I/O j 
j Control j Console j (Non-disk) j 
j Programj Simulation! Simulation! 
l x x x__. 

I I I 

02300 09700 11000 



| ABSLOD | 

I I 

| (IK) | 
-X X- 



Step 3 

r t t t 1 

I 1620 | CPU and | I/O | Simulated | 
| Control j Console j (Non-disk) j 1620 Core j 
j Programj Simulation! Simulation j Storage j 
l x x x J 

I I I 

02300 09700 11000 

Figure 2. System/360 Main Storage Allocation for SIM20 (No Disks) 
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Step 3 (Setting Simulated 1620 Core 
Storage) : Control is then transferred to 
SIM20, which sets simulated 1620 core stor- 
age to zero, starting at address 11000. 
Storage is set to zero through address 
30999 to simulate a 20 , 000-position 1620; 
through address 50999 to simulate a 
40, 000-position 1620; through address 70999 
to simulate a 60 , 000-position 1620. 

Storage- Resident I/O (Including Disk) 
Routines 

Step 1 (IPL) ; Same as step 1 for EDITOR. 

Step 2 (Absolute Load) ; The same as step 2 
for a 1620 with no disk storage drives, 
except that the disk simulation routines 
are loaded into addresses 12300 through 
14199 (see Figure 3). 

Step 3 (Setting Simulated 1620 Core 
Storage) : Control is then transferred to 
SIM20, which sets simulated 1620 core 
storage to zero, starting at address 14200. 
Storage is set to zero through address 
34199 to simulate a 20 , 000-position 1620; 
through address 54199 to simulate a 40, 000- 
position 1620; through address 74199 to 
simulate a 60 , 000-position 1620. 

Disk- Resident I/O (Including Disk) Routines 

Step 1 (IPL) ; Same as step 1 for EDITOR. 

Step 2 (Absolute Load): ABSLOD loads a 
condensed SIM20 version of CONTPR into 
addresses 00000 through 02299; it then 
loads SIM20. CPU and console simulation 
routines are loaded into addresses 02300 
through 09699, and I/O simulation routines 



(other than those for disks) are loaded 
into a 2,000-byte reserved area at address- 
es 09700 through 11699 (see Figure 4). 

Step 3 (Setting Simulated 1620 Core 
Storage) ; Control is then transferred to 
SIM20, which sets simulated 1620 core stor- 
age to zero, from address 11700 through 
31699. 

When a 1620 disk instruction is encoun- 
tered, the disk simulation routines are 
read into System/360 main storage in the 
2,000-byte reserved area from address 09700 
through 11700, thus overlaying the other 
I/O simulation routines. 



DSKINT 

The System/360 main storage allocation 
for SIM20 when a 1620 installation with 
disk storage drives is being simulated 
depends on whether or not the disk simula- 
tion routines are permanently in main stor- 
age. In either case, DSKINT must be used 
to place certain initial information on the 
2311 Disk Storage Drive. 

The main storage allocation for DSKINT 
is given in the following steps and is 
illustrated in Figure 5 (see Chart AC) . 

Step 1 (IPL) : Same as step 1 for EDITOR. 

Step 2 (Absolute Load) : ABSLOD loads a 
condensed SIM20 version of CONTPR into 
addresses 00000 through 02299; it then 
loads SIM20 and DSKINT. CPU and console 
simulation routines are loaded into 
addresses 02300 through 09699, I/O simula- 



Step 1 (Same as in Figure 1) 



12300 

Step 2 | 

r T T T + T 1 

| 1620 | CPU and | I/O | | Disk | | 
j Control j Console j (Non-disk) j j j Simulation! j 
I Program j Simulation j Simulation III I 
l x x x x x J 

III I 

02300 09700 11000 14200 



12300 

Step 3 | 

r T T T + T 1 

| 1620 | CPU and | I/O | | Disk | Simulated | 
jcontrolj Console j (Non-disk) j jsimulationj 1620 Core j 
j Programj Simulation! Simulation! j j Storage j 
l x x x x x J 

I I I I 

02300 09700 11000 14200 

Figure 3. System/360 Main Storage Allocation for SIM20 
(Storage-Resident Disk Simulation Routines) 
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tion routines (other than those for disks) 
are loaded into addresses 09700 through 
10999, disk simulation routines are loaded 
into addresses 12300 through 14199, and 
DSKINT is loaded into addresses 16400 
through 24599. 



Step 3 (Disk Initialization); Control is 
then transferred to DSKINT, which on opera- 
tor request: 

1. Places certain initial information on 
a specified 2311 Disk Storage Drive 
and establishes the format of informa- 
tion on this storage drive 

2. Loads SIM20 onto the same 2311 Disk 
Storage Drive, in a self-loading for- 
mat 

System/360 main storage is then dumped 
onto disk, as follows: 

• CONTPR and CPU and console simulation 
routines onto cylinder 00 

• The I/O simulation routines (other than 
those for disks) onto cylinder 01 



• The disk simulation routines onto cyl- 
inder 02 

DSKINT is not loaded onto disk; in order 
to be used again, it must be re-loaded from 
cards . 

For a subsequent SIM20 run, SIM20 alone 
is loaded from disk, using an IPL proce- 
dure. 

Note: "Console Simulation" includes the 
Insert and Automatic Load operations. 



UPDT20 

System/360 main storage allocation for 
UPDT20 is given in the following steps and 
is illustrated in Figure 6 (see Chart AA) . 

Steps 1 through 3: Same as steps 1 through 
3 for EDITOR. 

Step 4 (Relocating Load) : After initiali- 
zation, control is transferred to RELLDR, 
which loads UPDT20 into System/360 main 
storage. It uses IOPACK for I/O opera- 



Step 1 (Same as in Figure 1) 



Step 2 

| f 1620 | CPU and J I/O J ] 
| Control j Console j (Non-disk) j j 
| Programj Simulation j Simulation j j 
l + + + J 

I I I 

02300 09700 11700 



Step 3 

r t T T 

I 1620 I CPU and | I/O j 
| Control | Console | (Non-disk) j 
j Program j Simulation j Simulation j 



Simulated 
1620 Core 
Storage 



02300 



09700 



I 

11700 



31700 



Figure 4 



System/360 Main Storage Allocation for SIM20 
(Disk- Resident Disk Simulation Routines) 



Step 1 (Same as in Figure 1) 
Step 2 



12300 



16400 



r t t t 1 t -r 

I 1620 | CPU and | I/O | | Disk | | 
| Control! Console j (Non-disk) j j Simulation! | 
| Program j Simulation j Simulation j j j j 
l + + + J- + -«- 

III I 
02300 09700 11000 14200 

Figure 5. System/360 Main Storage Allocation for DSKINT 



DSKINT 



I 

24600 
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tions, and uses certain facilities of 
CONTPR. 



SIM20 and DSKINT are in symbolic form, and 
the sample program is in BCD code. 



LAYOUT OF THE SIMULATOR ON TAPE 

The Simulator system tape distributed by 
IBM contains the four programs (SIM20, 
EDITOR, DSKINT, and UPDT20), the five com- 
mon subprograms (ABSLOD, CONTPR, IOPACK, 
INIT, and RELLDR) , and the sample program 
described in the publication IBM System/360 
Conversion Aids: The 1620 Simulator for IBM 
System/360 , Form C28-6529. EDITOR, UPDT20, 
and the common subprograms are in binary. 



The way in which these programs and 
subprograms are placed on tape is shown in 
Figure 7. There is a tape mark at the end 
of each program and at the end of the 
common subprograms. Following the last 
binary program (EDITOR) is a one- card 
binary file, labeled SYSINEND, which marks 
the end of the binary system tape. This 
file is followed by a tape mark, SIM20, 
DSKINT, and another tape mark. At the end 
of the system tape is the sample program, 
in BCD code, followed by two tape marks. 



Steps 1 through 3 (Same as in Figure 1) 
Step 4 



r T T T T" 

| CONTPR | IOPACK | I/O | UPDT20 | 
j j | Control I | 
| (3K) | (3K) j Blocks | (7K) | 
L X J X X. 



Figure 6. System/360 Main Storage Allocation for UPDT20 



r 

1 1 PL 



— T T T T T T 1 T" 

+1 I I I I I I I 

| j CONTPR j IOPACK j INIT j RELLDR j UPDT20 j EDITOR j j 

|ABSLOD| | | | | | || 
L X J X X X X X_X. 

t 



"T Tl 

| Sample | | 

I II 
| Program | | 
.x XJ 



SIM20+DSKINT 



SYSINEND 
End of System Tape 



Figure 7. Layout of Programs on the System Tape 
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Chart 



AA. Overall Logic of EDITOR/ UPDT20 



***** 

*AA * 

* B2* 
* * 



ABSOLUTE 



*************** 



X 

******C4*********** 

****C5*»* ****** 
* CONTPR * * ENTERED ON * 

AND X .(-INTERRUPTION OR* 

* IOPACK » * I/O REQUEST * 

*************** 

************* 



•INITIALIZATION *X. 



***************** 



**** 
* * 
.* D2 * 



■ CALL • 
CONTROL 
CARD 



*****F3********** 

* * 

* SEND ADDRESS » 
K* OF EDITOR * 

* TO RELLDR * 

* * 
***************** 



*****G2********** 

* * 

* SEND ADDRESS * 

* OF UPDT20 * 

* TO RELLDR * 

* * 
***************** 



.* *. YES 

. COMMUNI CATION.*.... 
*. REQUEST .* 



**** 

* * 

* D2 » 



* K2 * 

* * 
**** 



***** 
*E A * 
* Bl* 
* * 



WHICH *. 
PROGRAM 
LOADED .* 



*CA * 
* B2* 
* * 



* K2 *.X 



**** 

RELLDR X 

*****K2********** 

* * 

* READ AND * 

* PROCESS *. 

* LOAD CARDS * 

* * 
***************** 
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Chart AB. Overall Logic of SIM20 (No Disk Simulation) 



***** 

* AB * 

* B2* 
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Chart AC. Overall Logic of SIM20 (With Disk Simulation) 
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SIM20 



SIM20 consists of the following logical 
sections: 

1. CPU simulation routines, which simu- 
late the 1620 CPU instructions 

2. I/O simulation routines, which simu- 
late 1620 I/O instructions 

3. Console simulation routines, which 
simulate the functions of the 1620 
Console; that is, keys, switches, and 
Automatic Load 



The way in which these logical sections 
perform the various functions of SIM20 is 
described in detail in the text devoted to 
the individual logical sections. Charts AB 
and AC show the overall logic of SIM20; 
that is, the relationship among the logical 
sections and CONTPR. 

When SIM20 has been loaded into 
System/360 main storage, control is trans- 
ferred to the console simulation section, 
which simulates the functions of the 1620 
Console and allows operator communication 
with SIM20. 



SIMULATED 1620 CORE STORAGE 

Each six-bit position of 1620 core stor- 
age is simulated by one byte in System/360 
main storage. 

Each 1620 instruction is represented by 
12 bytes. The first two bytes contain the 
operation code of the instruction, the next 
five bytes contain the P address, and the 
last five bytes contain the Q address. If 
one or both addresses are missing, the 
corresponding 5- or 10-digit fields may be 
used by the 1620 program for storing data, 
as is usual in 1620 programming. 

Representation of 1620 Positions 

Each six-bit position is simulated by a 
System/360 byte, as follows: 

r _ r - T - r - r - r — ! 
1620 jc F|8 4 2 1| 

L_J __L_J _J _J _J 



t~ r~ r - r _ T _ r~ r - r~i 
System/360 |8421|8421| 

L_J _J _J _J._J _J I _J 

zone numeric 



The CPU simulation section simulates 
1620 CPU instructions. It gives control to 
the I/O simulation section or to the con- 
sole simulation section whenever it encoun- 
ters an I/O or console instruction, or 
whenever an I/O or console interruption has 
been signaled by CONTPR. 

The I/O simulation section simulates 
1620 I/O instructions, calling on CONTPR to 
perform any necessary physical I/O opera- 
tions. 



CPU SIMULATION 

This logical section of SIM20 is made up 
of the following parts : 

1. Simulated 1620 core storage 

2. Simulated 1620 index registers (Model 
2) and storage registers 

3. Basic Interpretive Routine 

4. Subroutines for address conversion 

5. Operation routines to simulate 1620 
instructions 

6 . Tables 



The 1620 parity- check bit is simulated 
by the parity bit of the byte. The zone 
part of the byte can contain either a 
hexadecimal D, which represents the flag, 
or a hexadecimal F, which indicates an 
unf lagged character. 

The meaning of the flag (D) depends on 
its position in the field. The different 
positions and their meanings are shown 
below. 



Position 



In the 
of a 

In the 
of a 

In the 



rightmost address 
field 

leftmost address 
field 
rightmost byte of 
an address field 
In the thousands, hun- 
dreds, or tens position 
of an address field 
In an entry in the Add 
table in simulated 1620 
core storage (Model 1 
only) 



Simulated 1620 numeric characters and 
numeric special characters are given in 
Table 1, and simulated 1620 alphameric 
characters and alphameric special charac- 
ters are given in Table 2. 



Meaning 
Minus sign 
Field mark 

Indirect ad- 
dressing 

Address in- 
dexing 

Carry 
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For all 1620 operations in the numeric 
mode, 1620 characters are represented in 
simulated core storage by the hexadecimal 
characters F0 through FF and DO through DF, 
and are processed directly. Numeric spe- 
cial characters, however, are truncated at 
processing time in arithmetic and compare 
operations, though they are not modified in 
simulated core storage. For example, FA is 
truncated to F0 when placed in a general 
register to be added to another digit; but 
it retains the value FA in simulated core 
storage. 



The rule used for truncating special 
characters is: the 8 and 2 bits are sup- 
pressed. Thus, 



FA 


is 


truncated 


to 


F0 | DA 


is 


truncated 


to 


DO 


FB 


is 


truncated 


to 


Fl j DB 


is 


truncated 


to 


Dl 


FC 


is 


truncated 


to 


F2|DC 


is 


truncated 


to 


D2 


FD 


is 


truncated 


to 


F3|DD 


is 


truncated 


to 


D3 


FE 


is 


truncated 


to 


F4 | DE 


is 


truncated 


to 


DH 


FF 


is 


truncated 


to 


F5 DF 


is 


truncated 


to 


D5 



Addressing of Fields 

A field is defined by the address of its 
rightmost byte, and is processed from right 
to left until a byte with a hexadecimal D 
in its zone part is encountered. The 
address of the byte being processed is 
placed in general register RP or RQ. As 
the bytes of a field are addressed consecu- 
tively, the contents of RP or RQ are 
decremented by one each time a byte is 
processed. 



Addressing of Records 

A record is defined by the address of 
its leftmost byte, and is processed from 
left to right until a byte with a hexadeci- 
mal A in its numeric part is encountered. 
The address of the byte being processed is 
placed in general register RP or RQ. Since 
the bytes of a record are addressed consec- 
utively, the contents of RP or RQ are 
incremented by one each time a byte is 
processed. 



Table 1. 1620 Numeric Characters and Numeric 
Special Characters 



r t 1 

| 1620 CHARACTER j SYSTEM/360 REPRESENTATION j 
( |. T ^ 

| | UNFLAGGED j FLAGGED j 

i- + + ^ 

| 0,1,2, ...9 | F0,F1,F2, . . .F9 | DO, Dl, D2, . . . D9 j 

| Record Mark j FA j DA j 

| Group Mark j FF j DF j 

| Numeric Blank | FC j DC | 

j Minus Zero j j DO j 

L X X J 



Table 2. 1620 Alphameric Characters and Alphameric Special 
Characters 



r T T T T T 1 



1620 | 
+- 


System/360 


| 1620 | 


System/360 


| 1620 


| S/360| 
4 -1 






"+ +" 




_| 




A | 


FUF1 


| R or -9 | 


F5F9 


j 8 


j F7F8 j 


B | 


F4F2 


1 s 1 


F6F2 


1 9 


j F7F9 | 


C j 


F4F3 


1 T 1 


F6F3 




| F0F3 j 


D | 


F4F4 


1 u 1 


F6F4 


| ) 


| F0F4 | 


E j 


FUF5 


1 v 1 


F6F5 


j + 


| FIFO | 


F | 


F4F6 


1 w 1 


F6F6 


1 $ 


| F1F3 | 


G | 


FUF7 


1 x 1 


F6F7 


1 * 


j F1F4 j 


H j 


F4F8 


1 Y 1 


F6F8 




j F2F0 j 


I 1 


F4F9 


1 z 1 


F6F9 


| / 


j F2F1 j 


J or -1 | 


F5F1 


1 o | 


F7F0 


1 i 


j F2F3 | 


K or -2 j 


F5F2 


1 1 1 


F7F1 


| ( 


| F2F4 | 


L or -3 j 


F5F3 


1 2 | 


F7F2 




| F3F3 | 


M or -4 j 


F5F4 


1 3 j 


F7F3 


1 a 


j F3F4 j 


N or -5 | 


F5F5 


j 4 | 


F7FU 


j Blank 


j F0F0 j 


O or -6 | 


F5F6 


1 5 | 


F7F5 


j Flagged Zero 


| F5F0 j 


P or -7 | 


F5F7 


1 6 j 


F7F6 


j Record Mark 


j F0FA | 


Q or -8 | 


F5F8 


1 7 1 


F7F7 


| Group Mark 


j F0FF | 



L X X X X X J 
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SIMULATED 1620 REGISTERS 

Although most 1620 registers are not 
directly simulated, their functions are 
simulated by System/360 general registers 
and by elements of System/360 main storage. 
The following description gives the corre- 
spondence between 1620 register functions 
and the System/360 elements used for their 
simulation. 



1620 Storage Registers 

The function of the 1620 storage reg- 
ister IR-1 is simulated by the System/360 
general register CNTR. 



The functions of registers IR-2 and PR-1 
are simulated by two full-words labeled IR2 
and PR1. 

The functions of the following 1620 
storage registers are performed by working 
registers (general registers WRl to WR6) : 

OR-1 
OR- 2 
OR- 3 
OR- 4 
OR- 5 
PR- 2 
PR- 3 
MAR 
MBR 
MDR 
OP 
CR-1 

Multiplier- Quotient 
Digit and Branch 

Since they are used only by the 1710 
Control System, the storage registers IR-3 
and IR-1 are not simulated. 



1620 Model 2 Index Registers 

Each of the two bands (Band 1 and Band 
2) of seven index registers is simulated by 
numeric core storage positions at simulated 
1620 addresses 300 through 339 (Band 1) and 
340 through 379 (Band 2). 



Simulator Registers 

In addition to the general registers 
used to simulate 1620 registers, certain 
general registers are used for SIM20 func- 
tions. These registers and their functions 
are given in Table 3. 

The two SIM20 base registers are not 
included in Table 3. The functions of 
these registers are described in the fol- 
lowing paragraphs . 



Table 3. Simulator General Register 
Assignment 

r t 1 

| SYMBOLIC | FUNCTION | 

| NAME | | 

j. + -J 

| MAPORG | Contains the address of the | 
I I first byte of simulated j 

| | 1620 core storage j 

|. + -I 

| SIZE | Contains the address of the | 

j | last byte of simulated 1620 j 

| j core storage j 

j. + ^ 

| RP | Contains the converted P | 

j j address of the current 1620 j 

j j instruction j 

j. + 1 

| RQ | Contains the converted Q | 

j j address of the current 1620 j 

j j instruction j 

i — + ^ 

| Rl, R2 | Contain subroutine return | 
j | addresses j 

h + -i 

| WRl to WR6 | Used as working registers | 

I I I 

L i. J 

SIM20 is divided into three logical 
parts in System/360 main storage. The 
first part is contained in the bytes with 
addresses 00000 through 04095, and any 
element in this part can be addressed 
directly. The second part is contained in 
the bytes with addresses 04096 through 

08191, and the third part in the bytes with 
addresses 08192 through 12287. 

The two base registers SIMBl and SIMB2 
are used in such a way that the address of 
any element of the second or third part of 
SIM20 can be expressed as the contents of 
SIMBl or SIMB2 plus a displacement. 

SIMBl always contains the value 4096, 
and is used to address the second part of 
SIM20. SIMB2 always contains the value 

8192, and is used to address the third 
part. 

When disk simulation routines are per- 
manently in main storage (on a System/360 
with 65,536 or more bytes of main storage), 
SIMB2 may temporarily contain the value 
12288, but is reset to 8192. 



BASIC INTERPRETIVE ROUTINE 

The Basic Interpretive Routine (BIR) is 
entered each time a 1620 instruction is 
encountered (see Chart BA) . It first 
checks the value of the bit which simulates 
the Start/Stop key. If the value is one, 
the Stop key is simulated, and the simulat- 
ed 1620 stops and enters the Manual mode. 
If the value is zero, the Start key is 
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simulated, and the simulated 1620 enters 
the Automatic mode. 

When the simulated 1620 is in the Manual 
mode, all the bits which simulate console 
keys and switches are scanned, the 
appropriate operations are executed, and 
the BIR is re-entered. When the simulated 
162 is in the Automatic mode, according to 
the value of the operation code of the 
current 1620 instruction (contained in the 
operation code table) , the following opera- 
tions are performed: 

1. The standard address conversion sub- 
routine is called, and the P address 
or the Q address, or both, are con- 
verted to binary. 

2. Depending on the type of 1620 instruc- 
tion, the indirect addressing or index 
address conversion subroutine, or 
both, are called. 



ADDRESS CONVERSION SUBROUTINES 

SIM20 contains three address conversion 
subroutines (see Chart BB) : a standard 
subroutine used for all 1620 instructions, 
an indirect addressing subroutine used by 
those 1620 instructions for which indirect 
addressing is specified, and an index sub- 
routine used when a band has been selected 
(1620 Model 2 only) . 

These subroutines are associated with 
the BIR, but, since not all 1620 instruc- 
tions require both P and Q addresses, are 
not incorporated into the BIR. Further- 
more, the subroutines are divided into 
three sections. P-address conversion only, 
Q- address conversion only, and P- and Q- 
address conversion. 

Standard Address Conversion Subroutine 

This subroutine converts the P address 
or the Q address, or both, into binary and 
adds the result to the contents of general 
register MAPORG. The contents of this 
register are then compared with the con- 
tents of general register SIZE to determine 
whether the address falls within the bounds 
of simulated 1620 core storage. If it 
does, control is transferred to the opera- 
tion routine which simulates the execution 
of the current 1620 instruction; if it does 
not, the message MAR CHK is printed on the 
1052 Printer-Keyboard, and simulation is 
stopped (the BIR enters the 1620 Manual 
mode) . 

Indirect Addressing Subroutine 

This subroutine is entered from the 
standard conversion subroutine, and tests 
for the presence of a flag in the units 



position of the address in general register 
Rl. If there is no flag, control is 
transferred to the operation routine which 
simulates the execution of the current 
instruction. If a flag is present, the 
indirect address is fetched from simulated 
core storage, and the procedure described 
under "Standard Address Conversion 
Subroutine" is executed until no further 
flag is found. 



Index Subroutine (1620 Model 2) 

This subroutine is entered from the 
standard conversion subroutine, and tests 
whether a band has been selected. If not, 
control is transferred to the indirect 
addressing subroutine. If so, the address 
of the index register is computed from the 
flag pattern of the address field of the 
instruction. The corresponding core stor- 
age field is packed, converted to binary, 
and added to the previously converted 
address. The result is compared with the 
contents of general register SIZE to deter- 
mine whether the address falls within the 
bounds of simulated 1620 core storage. If 
the resulting 1620 address is greater than 
the address of the last byte of simulated 
core storage, it results in a MAR CHK 
indication. If the resulting 1620 address 
is negative, it is replaced by the 
System/360 effective address corresponding 
to the ten's complement of this negative 
address. Control is then transferred to 
the indirect addressing subroutine. 



CPU SIMULATION PROCESS 

Chart BA gives the overall operation of 
the CPU simulation section of SIM20. The 
following paragraphs describe this opera- 
tion. 

The BIR is entered each time a 1620 
instruction is encountered. After having 
decoded the instruction, it places the 
simulated 1620 in either the Manual or the 
Automatic mode. When it is in the Manual 
mode, the bits which simulate the 1620 
console keys and switches are scanned, and 
control is returned to the BIR. When it is 
in the Automatic mode, the execution of the 
current 1620 instruction is simulated. 

When the instruction has been executed, 
the indicators involved in the operation 
are updated, the instruction counter CNTR 
is incremented by 12 (except for 1620 
Branch instructions, where CNTR contains 
the P address) , and control is returned to 
the BIR. 

The simulation of 1620 CPU instructions 
normally consists of three distinct steps: 
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1. Converting 1620 addresses into effec- 
tive System/360 binary addresses 

2. Simulating the proper function of the 
instruction 

3. Updating indicators (if necessary) 

Charts BC, BD, and BE illustrate the 
logic of three typical routines used to 
process arithmetic operations in either 
fixed or floating point. The FIX ADD rou- 
tine adds two fields, digit by digit; the 
MULT routine multiplies two fields; and the 
FIXDIV routine divides two fields. 

FIXADD Routine 

The FIXADD routine (see Chart BC) adds 
two fields, using either the simulated 1620 
Model 1 core storage tables (1620 addresses 
300 through 399) or 1620 Model 2 direct 
addition. In both cases, each digit to be 
processed is converted before addition, 
using internal table look-up. This method 
allows the use of the FIXADD routine for 
subtraction as well as addition, using 
complement tables. 

MULT Routine 

The MULT routine (see Chart BD) directly 
simulates the 1620 multiplication process. 
Each partial product is computed from the 
multiply tables at simulated 1620 addresses 
100 through 299, and is added to the 
product area. A carry is propagated from 
right to left as many times as necessary. 
The process is repeated for each digit of 
the multiplier field, the partial product 
being added each time to the preceding 
result. 

When the leftmost flag in the multiplier 
field is encountered, the process is termi- 
nated and the indicators are updated. In 
fixed-point multiplication, the product is 
left in the product area; in floating-point 
multiplication, it is shifted (if 
necessary) and moved to the P field. 

FIXDIV Routine 

The FIXDIV routine (see Chart BE) 
directly simulates the 1620 automatic 
divide process. The Q field is subtracted 
(that is, added in complement form), digit 
by digit, from the dividend. This subtrac- 
tion loop is repeated until a leftmost 
carry of zero is obtained, indicating that 
one operation too many has been performed. 
The divisor field is then shifted one 
position to the right, and the subtraction 
loop is repeated. The division is termi- 
nated when the rightmost address of the 
divisor corresponds to the rightmost 
address of the dividend. The indicators 
are then updated. 



TABLES 

There are two types of tables in the CPU 
simulation section of SIM20: an operation 
code table and code conversion tables. 



Operation Code Table (OPTBL) 

OPTBL is made up of 154 half -words, 
containing the absolute addresses in 
System/360 main storage of the routines 
which simulate the 1620 instructions. This 
table allows a maximum of 99 operation 
codes, of which some may be invalid on the 
particular 1620 system being simulated, and 
of which some are always invalid since they 
correspond to no existing 1620 operation 
code. 

The Basic Interpretive Routine uses this 
table in order to transfer control to the 
appropriate routine to simulate a particu- 
lar 1620 instruction. The BIR packs the 
operation code, multiplies it by two, and 
uses the result as an index in OPTBL. The 
half-word at the index is placed in general 
register Rl, and control is then trans- 
ferred to the address in Rl. 



Code Conversion Tables 

Code conversion tables are used by the 
routines which simulate 1620 I/O operations 
(other than those for disk) . Code conver- 
sion is not necessary for disk operations, 
since the code on disk is the same as that 
in main storage. 

Code conversion is performed by the MASK 
subroutine: after filling the buffer, and 
before transferring the data to simulated 
storage (input operations) ; and after 
transferring data from simulated storage to 
the buffer, and before emptying the buffer 
(output operations) . The I/O simulation 
routine which calls the MASK subroutine 
places the address of the appropriate code 
conversion table in a working register. 

Each table is made up of a series of 
character strings. The last character 
string in the table is followed by a 
delimiter character (either X'EE* or X'EF', 
depending on the type of table) . This 
delimiter character is used to stop table 
loading. 

Each character string can contain a 
variable number of characters. The first 
character is a relative address index which 
indicates at which address in the zone the 
string should be loaded. The second char- 
acter contains the length (in the form L-l) 
of the character string. The data in the 
string starts at the third character and 
contains L characters. 
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I/O SIMULATION 

This section of the PLM contains a 
general description of the I/O simulation 
section of SIM20. Among the topics dis- 
cussed are the simulation of 1620 I/O 
devices, buffer formats, and the general 
technique of I/O simulation. 



CHANNEL CONTROL BLOCKS 

One channel control block (CCB) in 
System/360 main storage is associated with 
each System/360 channel used by SIM20. 
SIM20 assumes that three CCBs have been 
created during an editing run; these CCBs 
correspond to multiplexor channel and 
selector channels 1 and 2. The CCB for a 
particular channel contains the address of 
the first byte of the unit control block 
for each device attached to the channel. 



• One console typewriter 

• One paper tape reader 

• One card reader 

• One card punch 

• One printer 

• Four disk storage drives 



When System/360 Operating System stan- 
dard addressing is used, two of the disk 
storage drives are attached to selector 
channel 1, two to selector channel 2, and 
the rest of the devices to multiplexor 
channel . 



The detailed structure of a UCB is 
given in Table 5. 



Since the 1620 system has no channels, 
there is no restriction on the assignment 
of 1620 I/O devices to System/360 channels. 
The assignment of I/O devices to channels 
conforms to System/360 Operating System 
standard addressing, and is set up by 
DEVICE control information during an edit- 
ing run. 

The detailed structure of a CCB is given 
in Table 4. 



Table 4. Structure of a CCB 



r t- 

WORD I 



CONTENTS 



Always contains zeros 



Contains the address of 
first byte of this CCB 



the 



One word for each System/360 
device attached to this channel, 
broken down as follows: 
The first byte contains the 
System/360 hexadecimal address 
of the device 

The last three bytes contain the 
address of the first byte of its 
associated UCB 



UNIT CONTROL BLOCKS 

One unit control block (UCB) in 
System/360 main storage is associated 
with each 1620 I/O device to be simulat- 
ed. UCBs are created from DEVICE control 
information during an editing run. A 
maximum of ten 1620 I/O devices, each 
with a corresponding UCB, can be simulat- 
ed, as follows: 



Table 5 . 
r 



Structure of a UCB 

"T 



SYMBOLIC 
NAME 



DEVTYP 



DEV360 



DEVSPF 



BORCH 



DEVSVC 



DEVCHN 



DEVINT 



SENSE 



CONTENTS 



Four bytes, containing the 
type of System/360 device 
(for example, 1442, 1052) 



Two bytes, containing the 
System/360 address of the 
device 



-H 



One byte, denoting the spe- 
cial features of the device 



-H 



One byte, giving the device 
status : 

00=available 

ll=busy 

01=chained 

10=busy, unit check encoun- 
tered 



Three bytes, containing the 
address of the SVC calling 
sequence 



-H 



Three bytes, containing, if 
chained, the address of the 
next UCB on the chain 



Three bytes, containing the 
return address in case of an 
interruption 



-H 



Three bytes, containing 
sense information 



INVST | One byte, containing any 
invalid status bits 
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CHANNEL TABLE 

The Channel Table (CHTABL) is a block of 
four consecutive full-words in System/360 
main storage. The first three full- words 
correspond, in order, to System/360 chan- 
nels 0, 1, and 2; each contains the address 
of the first byte of the CCB associated 
with the corresponding channel. The fourth 
full-word must contain zeros. 



BUFFERS 

Only one I/O buffer is used by SIM20 
since the processing of 1620 CPU instruc- 
tions is interrupted only during the trans- 
fer of data from simulated 1620 core stor- 
age to the buffer, or from the buffer to 
simulated core storage. 

The length of this buffer is set at 210 
bytes, based on the following considera- 
tions : 

1. I/O operations on the console type- 
writer and on paper tape devices are 
executed with groups of 100 charac- 
ters, or fewer when a record mark or 
an end of block is detected. 

2. I/O operations on a card read- punch 
device are executed with groups of 80 
characters . 

3. Output operations on the printer may 
process up to 144 characters at a 
time. 

4. I/O operations on disk storage drives 
use two fields of 105 bytes each. 

For 1620 I/O operations in the Alphamer- 
ic mode, the expansion of each character 
read (or the reduction of each two-digit 
field to a written character) is performed, 
one character at a time, during code con- 
version. Thus, a double-length I/O buffer 
is not necessary. 



LOGIC OF I/O SIMULATION 

Depending on the characteristics of the 
1620 system to be simulated, EDITOR pro- 
duces one of two versions of the I/O 
simulation section. 

1. To simulate 1620 systems that have 
disk storage drives and are too large 
to be simulated on a System/360 with 
32,768 bytes of main storage, SIM20 is 
edited in the following way: 

a. I/O simulation routines for 1620 
disk operations are placed on cyl- 
inder 2 of a 2311 Disk Storage 
Drive; I/O simulation routines for 



console typewriter, paper tape 
device, card read punch, and 
printer operations are placed on 
cylinder 1; and the rest of SIM20 
is placed on cylinder 0. At the 
beginning of simulation, the con- 
tents of cylinders and 1 are 
read into System/360 main storage. 

b. During simulation, when a 1620 
disk operation is to be performed, 
SIM20 transfers the I/O simulation 
routines for disks from the 2311 
into System/36 main storage, 
overlaying the I/O simulation rou- 
tines (except Insert and Automatic 
Load) for the other 1620 devices. 
The 162 disk operation is then 
simulated. 

c. Later, when a 1620 I/O operation 
is to be performed on a device 
other than a disk storage drive, 
the disk simulation routines are 
replaced in System/360 main stor- 
age by the I/O simulation routines 
for the other 1620 devices. 

The overall logic of this version 
of the I/O simulation section is shown 
in Chart BA. 

2. Few 1620 systems reguire the above- 
described I/O simulation technique. 
When simulating most 1620 systems, all 
the I/O simulation routines remain 
permanently in System/360 main 
storage, and all 1620 I/O operations 
(including disk operations) are per- 
formed as soon as reguested. 



I/O SIMULATION ROUTINES (OTHER THAN DISK) 

The BIR analyzes the operation code of 
the I/O instruction and, according to its 
value, transfers control to the appropriate 
simulation routine (see Charts BF, BG, and 
BH) . The method of simulation depends on 
whether the instruction requests a read or 
a write operation. 

Read Operation 

A read operation is performed in the 
following way: 

1. Information is read from an I/O device 
into the I/O buffer. The physical 
transfer of data from the device to 
the buffer is performed as follows: 

a. SIM20 submits an I/O and continue 
(SVC 2) or an I/O and interrupt at 
channel end (SVC 1) request to 
CONTPR. 

SVC 1 is used in card read punch 
and printer simulation; SVC 2 is 
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used in typewriter, paper tape, 
and disk simulation. 

b. Control is transferred to CONTPR. 

c. The physical read operation is 
begun . 

d. Control is returned to SIM20 as 
soon as the request is accepted. 

2. The MASK subroutine is called and, if 
so indicated by the command- check 
byte, loads the code conversion table. 
When the table has been loaded, the 
"lock switch" in the I/O request 
sequence is turned on. At channel 
end, CONTPR tests for exceptional con- 
ditions that may have been detected 
during the read operation. If none 
have been detected, control is 
returned to SIM20. 

3 . The VALIN subroutine converts the 
information in the buffer into SIM20 
internal code and checks the validity 
of all characters . 

4 . The information is transferred from 
the I/O buffer into simulated 1620 
core storage. 

5. The 1620 I/O indicators and switches 
associated with the operation are 
updated, and control is passed to the 
BIR to analyze the next 1620 instruc- 
tion. 



Unrecoverable Errors: I/O errors involving 
a channel or a control unit are classed as 
unrecoverable errors. When such an error 
is detected, a message is sent to the 
operator, and control is transferred to the 
BIR. The simulated 1620 is placed in the 
Manual mode. 

Intervention Required; When intervention 
is required at an I/O device, a message is 
sent to the operator, and control is passed 
to the BIR. 

The operator message simulates the sta- 
tus of a 1620 I/O indicator. The simulated 
1620 enters the Manual mode, and the opera- 
tor must perform a 1620 Start operation in 
order to resume simulation of the instruc- 
tion. 

Unit Exception: The response of SIM20 to a 
unit- exception condition depends on the 
type of read operation being performed. 
This condition may, for example, denote a 
last- card or cancel indication. 

Unit Check: When a unit-check condition 
occurs, a sense operation is performed at 
the device; according to the resulting 
sense information, the 1620 I/O indicators 
concerned are set "on". If no indicators 
are involved in the operation, the standard 
error recovery procedures are performed. 



DISK SIMULATION ROUTINES 



Chart BG shows the overall logic of a 
read operation. 

Write Operation 

The simulation of a write operation is 
similar to that of a read operation; it is 
performed in the following way: 

1. The VALOUT subroutine converts the 
information in the buffer from SIM20 
internal code into the appropriate 
output code and checks the validity of 
all characters . 



The following sections present the tech- 
nique used in the I/O simulation section of 
SIM20 to simulate 1620 disk operations. 



Sector Arrangement 

On the disk packs for 1311 Disk Storage 
Drives, the 20 sectors of any one track are 
arranged consecutively from to 19. On 
the disk packs for 2311 Disk Storage 
Drives, the sectors are rearranged as shown 
in Figure 8. 



2. The information is transferred from 
simulated 1620 core storage into the 
I/O buffer. 

3. The physical write operation is per- 
formed. 

Chart BH shows the overall logic of a 
write operation. 

Exceptional Conditions 

The following exceptional conditions may 
occur during the execution of an I/O opera- 
tion. 
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Figure 8. Disk Sector Arrangement 

This rearrangement of sectors allows 
efficient simulation of 1620 disk opera- 
tions involving a number of consecutive 
1311 sectors in logical sequence. For 
example, the processing of a series of 
sectors during a 1620 Read Disk operation 
is simulated in the following way: 



1. 



The first sector in the series is read 
into the I/O buffer. 
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2. A certain amount of CPU processing is 
performed to check the results of the 
operation. 

3. The data is transferred from the I/O 
buffer into simulated 1620 core stor- 
age. 

4. A counter is incremented in order to 
read the next sector in the series. 

While steps 2, 3, and 4 are being 
executed, the two sectors immediately fol- 
lowing the sector just read pass under the 
read/write head of the disk unit. For this 
reason, the sectors are arranged in the 
order: 

n,n+7, n+14,n+l,n+8,n+15, . . . 

The result is that when SIM20 is ready to 
accept the next sector in logical sequence, 
that sector is the next one to pass under 
the read/write head. 

This rearrangement of sectors reduces 
the processing time for multi-sector opera- 
tions from 4.25 ms per sector (1311 Disk 
Storage Drive) to 3.57 ms per sector. 

Each sector on a 2311 track is made up 
of the following elements: 

• Identification 

• Key length (=0) 

• Count (=105 bytes) 

• 105 bytes of data (the first 5 bytes 
contain the sector address, and the 
last 100 the contents of the sector) 

An additional 21st sector is placed at 
the end of each 2311 track; it contains the 
1620 addresses of the 20 preceding sectors. 
Since each 1620 sector address is 5 bytes 
long, this sector contains 100 bytes. It 
is used by SIM20 to check the addresses of 
the sectors on the track; when the sector 
addresses are modified as a result of a 
1620 disk operation, its contents are 
changed accordingly. 

Disk Indicators 

The 1620/1311 indicators 

36 (address check) 

37 (WLRC/RBC) 

38 (cylinder overflow) 

and the read- and write- check indicators 06 
and 07 are simulated by bits in System/360 
main storage. These indicators are set by 
the SIM20 sequences which perform address 
comparison on the 21st sector, check cylin- 
der overflow by arithmetic computation, and 



perform a wrong-length record check by 
character comparison. 



Write Address Switch 

The write-address switch is simulated by 
bit 5 of the byte at System/360 address 
00001. When "on", it allows 1620 programs 
to modify the addresses of sectors on 2311 
tracks; when the addresses are modified, 
the contents of the 21st sector of the 
track are changed accordingly. 



Protection Flag 

As on the 1620, write protection in 
SIM20 consists in placing a flag on the 
leftmost position of the sector address; 
that is, in the first of the 105 data 
bytes . 



Disk Addresses 

SIM20 determines the 2311 cylinder and 
head numbers by converting the disk control 
field specified by the 1620 disk instruc- 
tion. The addresses thus defined are 
placed in System/360 main storage so that 
they can be used by further 1620 disk 
instructions . 



Disk Read, Write, and Check Instructions 

When one of these 1620 disk instructions 
is encountered, the Disk Operation Entry 
routine (see Chart BM) is called. This 
routine makes a number of tests: 

• Read, write, or check operation (Charts 
BP,BQ,BR) 

• Track or sector mode 

• With or without WLRC/RBC (wrong- length- 
record check, read-back check) 

Depending on the result of these tests, 
it then passes control to the appropriate 
routine. 

Sector Mode Operations: A loop processes, 
one at a time, the sectors of a sequence, 
regardless of the length of the sequence. 
The routine increments a counter as neces- 
sary, and checks the results of the opera- 
tion from sector to sector and track to 
track. 

Track Mode Operations : These are also 
performed sector by sector (including the 
processing of sector addresses) until the 
20th sector has been processed. This 
requires three rotations because of the 
disk sector arrangement chosen. 
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Seek Operations 

The simulation of a 1620 seek operation 
(see Chart BN) is performed in the follow- 
ing steps: 

1. Conversion of the contents of the disk 
control field 

2. Issuance of a System/360 Seek Cylinder 
and Head command 



CONSOLE SIMULATION 

SIMULATED KEYS, SWITCHES, AND INDICATORS 

All 1620 console keys, switches, and 
indicators are simulated by bits in a 
double-word at System/360 address 00000, 
since SIM20 tests these bits when the 
simulated 1620 is in the Manual mode. The 
functions of simulated keys, switches, and 
indicators are simulated only when the 
simulated 1620 is in the Manual mode. The 
operator can change the settings of keys 
and switches directly by manipulating 
System/360 control panel switches. SIM20 
can also display the status of 1620 indica- 
tors in such a way that the operator can 
read them directly on the system control 
panel . 

Simulated Console Keys 

1620 Model 1 and Model 2 console keys 
are simulated by seven bits in the byte 
with System/360 address 00000. 

• The Start and Stop keys (bit of the 
byte) are simulated by the same 
System/360 control panel switch: 

OFF=Start key (bit contains zero) 
ON=Stop key (bit contains one) 

• The Automatic Load key of the 1622 Card 
Reader is simulated by bit 6 of the 
byte. Its function is simulated only 
when the simulated 1620 is in the 
Manual mode. Setting the bit to one 
corresponds to pressing the Automatic 
Load key. 

The correspondence between simulated 
1620 console keys and the bits of byte 
00000 is given in the listing of SIM20. 

Simulated Console Switches 

1620 Model 1 and Model 2 console switch- 
es are simulated by eight bits in the byte 
with System/360 address 00001. The first 
four bits of this byte correspond to 1620 
program switches 1, 2, 3, and 4; the 
following bit, to the disk-check switch; 
and the last two, to the I/O-check switch 



(read check, write check) and the overflow 
switch (arithmetic check, exponent check) . 

The function of the 1620 parity bit is 
simulated by the parity bit of the 
appropriate System/360 byte; therefore, the 
1620 parity-check switch is not simulated. 

Bit 5 of byte 00001 simulates the write- 
address switch, which is used by 1620 
programs that modify sector addresses on 
1311 Disk Storage Drives. Its effect is 
simulated only during 1620 disk operations. 

The correspondence between simulated 
1620 console switches and the bits of byte 
00001 is given in the listing of SIM20. 

Simulated Indicators 

1620 Model 1 and Model 2 indicators are 
simulated by 17 bits in System/360 main 
storage at addresses 00002 through 00007. 
Indicators 19 and 39, which summarize the 
other indicators, are not simulated. When 
a BI or BNI instruction requests that 
indicator 19 or 39 be tested, the corre- 
sponding detailed indicator bits (indica- 
tors 06+07+25+36+37+38) are tested simulta- 
neously. 

The third bit of byte 00002 is used as 
the "paper tape switch." If this bit 
contains a 1, the 1621 Paper Tape Reader is 
simulated by a card reader; if it contains 
zero, the 1621 is simulated by the 2671 
Paper Tape Reader. 



LOGIC OF KEY SIMULATION 

The simulation of 1620 console keys 
(except the Stop key) is effective only 
when the simulated 1620 is in the Manual 
mode. 

The BIR, which is given control whenever 
a 1620 instruction has been completely 
processed, tests the value of the 
start/stop bit (bit 0) at System/360 
address 00000. If this bit contains a 
zero, simulation continues with the next 
1620 instruction in sequence. If this bit 
contains a one, control is passed to a 
closed loop, which tests successively the 
value of the save, reset, check reset, 
insert, modify, and automatic load bits. 
If all these bits contain zeros, the 
sequence loops endlessly. As soon as a 
value of one is encountered, the corre- 
sponding functions are performed. These 
bits can be set by storing them in 
System/360 main storage through the system 
control panel. 

When one of the save, check reset, or 
insert operations is performed, control is 
returned to the closed loop, and the simu- 
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lated 1620 remains in the Manual mode. The 
only way to exit from this loop is to 
perform a Start or Automatic Load opera- 
tion; that is, to set the start/stop bit to 
zero. Control is then returned to the BIR, 
which resumes simulation of 1620 instruc- 
tions . 

When the automatic load bit contains a 
one, control is passed to the Read Numer- 
ically (Card) sequence, which reads the 
first card into simulated 1620 core stor- 
age, at address 00000, sets the contents of 
the simulated instruction counter to 00000, 
and sets the start/stop bit to zero, with- 
drawing control from the closed loop. 
Loading then begins immediately. 

When the modify bit contains a one, the 
corresponding function is performed (all 
simulated 1620 core storage is set to 
zero) , provided that the start/stop bit 
contains a zero. When simulated core stor- 
age has been cleared, the start/stop bit is 
set to one, and the closed loop is re- 
entered. 

The logic of key simulation is shown in 
Charts BA, BK, and BL. 



MESSAGES AND COMMANDS 

All I/O operations on the 1052 Printer- 
Keyboard are performed by the TYPIO 
subroutine, which may be given control at 
any time, provided that it has been given 
the necessary information: a device 
address, a read or write command, a count, 
and the address of a buffer. This general 
purpose routine is used by: 

• The MESSAG subroutine, which prints all 
SIM20 messages on the 1052 Printer- 
Keyboard 

• The ALARM sequence, which performs the 
error recovery procedures for the 1052 

• The INSERT, RNTY, RATY, WNTY, WATY, and 
DNTY sequences, which simulate 1620 
console typewriter operations 

MESSAG Subroutine 

The MESSAG subroutine is given control 
whenever a part of SIM20 must display a 
message on the 1052 Printer-Keyboard. It 
contains three options : 

1. Send a message and continue simula- 
tion. 



2. Send a message and stop the BIR. 

3. Send an INTERVENTION REQUIRED message 
(such as Reader No Feed) , stop the 
BIR, and return control to the BIR 
without incrementing the simulated 
instruction counter. The operator can 
then re- start simulation on the same 
1620 instruction as soon as the 
required device is ready. 

The MESSAG subroutine processes every 
message, provided it is given the message 
address (that is, the first character of 
the string representing the message) . This 
character must contain the length of the 
message proper, which begins with the next 
byte. 



RNTY Sequence 

The RNTY sequence simulates the 1620 
Insert, Read Numerically (Typewriter) , and 
Read Alphamerically (Typewriter) instruc- 
tions. All three instructions are pro- 
cessed using modifier switches. 

An Insert operation issues a read com- 
mand on the 1052, with a count of 100 
bytes. These 100 bytes are converted into 
SIM20 internal code and placed in simulated 
1620 core storage, starting at address 
00000. The closed loop of the BIR is then 
re-entered, ready for a start operation. 

A Read Numerically or Alphamerically 
operation is processed by sending commands 
to read 100 bytes to the 1052, converting 
these bytes, and placing them in simulated 
1620 core storage. This process is repeat- 
ed until an end-of-block indication is 
encountered. 

Note that an Insert, a Read Numerically, 
or a Read Alphamerically operation must not 
be terminated by a Release and Start opera- 
tion, as is done on a 1620, because the 
end-of-block indication is the only one 
that can release the 1052 Printer-Keyboard, 
by sending channel-end and device-end indi- 
cations to SIM20. 



Write Numerically and Alphamerically 
Operations 

These operations are performed in the 
same way as the insert and read operations: 
by sending commands to the 1052 to write 
strings of 100 bytes until a record mark is 
detected in simulated 1620 core storage. 
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Chart BA. SIM20 Internal Logic 
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Chart BB. Address Conversion Subroutines 



P OR Q ADDRESS CONVERSION 
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•INDEX' OR • I NDAD • SUBROUTINES MAY BE ABSENT. 
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Chart BC. FIXADD Routine 
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Chart BD. MULT 
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Chart BE. FIXDIV Routine 
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**•***••*****•••* . **••*•••••**•• 



FIXDI . X 

♦ADDPQ * '. * * 

*-*-*-*-*-*-*-♦-♦ . * SET FLAG AND * 

* SUBTRACT *X... * SIGN ON < 
♦LAST DIGIT FROM* * REMAINDER * 

* P FIELD * * * 
***************** ************** 



X . 

FIXDIE .*. FIXD5 .♦. X 

Jl *. J2 *. *****J3********** 

• * *• •* *. * * 

.♦ TEST *. ZERO .» ♦. NO ♦ DEFINE * 

*. LAST CARRY .* X^.P FIELD NULL ...... ♦ SIGN OF ♦ 

♦. .* *. .* . * QUOTIENT * 

♦ . .* *••*•* * 

*. .* *. .* X ***************** 
* ONE * YES **** 

.X. * 63 * 

X ♦ * X 



**«« 



RETURN 
TO CALLING 
SEQUENCE 
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Chart BF. Simulation of I/O (Other Than Disk) Operations 



***** 

*BF * 
* C2* 



REQUESTED 
SEQUENCE 
. IN CORE . 
•STORAGE* 



OUTIN6 

******C4*********« 
LOAD ENTIRE SE- 
•QUENCE OF DISK « 
...X SIMULATION FROM 
CYLIND. 02 INTO 
CORE STORAGE 
************* 



0UTIN2 X 

******D3**********« 
LOAD ENTIRE 
♦SEQUENCE OF I/O* 
SIMULATION FROM 
CYLIND. OX INTO* 
CORE STOR. 
************* 



«****£2 ********** 

* * 

* GIVE CONTROL * 

* TO THIS *> 

* SEQUENCE * 

* * 
***************** 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



Chart BG. Logic of Read Operations 




***** A 3* ******** 

* REQUEST A 
*READ OPERATION 

* FROM CONTROL 
♦PROGRAM BY SVC 



SI M 20 
CONTROL PROGRAM 



• * ARE *. 

» 1620 

INDICATORS 
►.INVOLVED . 



t««*Dl********* 
SEND MESSAGE 
AND SET 
■STOP' BIT 
► TO ONE ' 
( MANUAL MODE) 
************* 



***»*D2 ******* 

♦SET APPROPRIATE 
*1620 INDICATORS* 

♦ AND MODE * 

* * 
************** 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



****«C3**^^^***** 

* PREPARE * 
•CODE CONVERSION* 

* TABLE * 



*****D3******* 
* * 

*SET READ SWITCH* 



RETURN TO THE 
POINT OF INTERRUPTION 
BY SVC 3 



E3 *. 

* "*. C 

READ SWITCH •*. 



VALIN X 

*****F3********** 

* TRANSLATE * 
♦INPUT DATA AND * 
♦CHECK VALIDITY * 

* * 
***************** 



X 

G3 "*. *****G4******* 

.* INVALID *• YES * SET 1620 * 

*. CHARACTER .*.. X* READ CHECK 

*. •* * INDICATOR ON * 

* NO 

.X 

X 

*BA * 
* C2* 
* * 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 
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Chart BH. Logic of Write Operations 



» PREPARE « 

»CODE CONVERSION* 
* TABLE * 



*****B3*» ******** 

* TRANSLATE * 
♦OUTPUT DATA ANO* 
♦CHECK VALIDITY * 



SET 162 
WRITE CHECK 
INDICATOR ON 



»****D3********** 
» REQUEST * 

* A WRITE * 
•OPERATION FROM *. 
•CONTROL PROGRAM* 

* BY SVC 1 * 



.* ARE *. 

* 1620 

I NDICATORS 
►.INVOLVED . 



SET * * 

WRITE SWITCH *X....» F4 
OFF * ♦ 



*»**G1 ********* 

SEND MESSAGE 
AND SET 
■STOP" BIT 
* TO ONE * 
( MANUAL MODE) 



♦SET APPROPRIATE 
♦1620 INDICATORS* 
* AND MODE * 



•WRITE SWITCH .*... 



RETURN TO 
THE POINT OF 
I NTERRUPTI ON 

BY SVC 3 



* F4 * 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



RETURN TO 
BASIC INTERPRETIVE 
ROUTI NE 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



SIM20 



Chart BK. Console Simulation Logic 



.X». 'SAVE' BIT 



KSAVE 

*»»**B2 ******* 

* SAVE * 

* INSTRUCTION * 

, . .X* COUNTER AND * 

* RESET ' SAVE ■ * 

* BIT TO ZERO* 
************** 



***»*C2 ♦♦***♦* 
» * 
♦RESET ALL CHECK 
K* INDICATORS * 

* TO ZERO * 

* * 
•••**•♦•♦♦••** 



**«**C3* ****** 

* « 

* RESET 

<* • CHECK RESET' 

* BIT TO ZERO 

************** 



Dl *. 
.« *. 

« 

•RESET" BIT 



KRESET 

»**»»Q2 ******* 
*RESET INSTRUCT. 

* COUNTER TO * 
...X*ORIGIN ADDRESS 

* OF SIMULATED * 
CORE STORAGE* 



*** 



»*****«« 



«*«*#D3******* 

* » 

♦RESET ALL 1620* 
<* INDICATORS 

* TO ZERO * 

* * 
♦*♦♦♦♦♦♦♦♦♦♦*# 



.X 

X 

.*• 

EI *. 
.* *. 
t ♦. = 

'INSERT' BIT .♦. 
*• •♦ 
♦. .* 
*• •* 



KINSER 

****»E2 ******* 
♦LOAD INSTRUCT. 

* COUNTER AND P* 
...X* REGISTER WITH 

* 1620 ADDRESS * 

* 00000 ♦ 
••*•••**•*••** 



KAUTO 

*«***F 2 *♦♦♦♦♦* 
♦LOAD INSTRUCT. 

♦ COUNTER AND P* 
...X* REGISTER WITH 

♦ 1620 ADDRESS * 

♦ 00000 ♦ 
*♦♦♦♦♦******** 



* ♦♦♦♦F3^^^** 

* * 

* RESET 'STOP' 
<* BIT TO ZERO 

* (AUTOMATIC 

* MODE) * 
*♦*«♦♦♦♦♦***** 



*♦♦♦♦ 
♦BG ♦ 
♦ A3* 



♦RESET SIMULATED 
<♦ 1620 CORE * 
♦STORAGE TO 'FO' 
♦ * 
♦♦♦****♦***♦♦♦ 



»**G4****«** 

RESET * 
'MODIFY' BIT 
TO ZERO AND 
•STOP- BIT 
TO ONE < 
************ 



* SET SIM20 * 
K* IN 1620 

♦AUTOMATIC MODE* 

* * 
************** 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 
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Chart 



BL. Insert Key Simulation 




*#»»*A2 ********** 

* INPUT * 

* REQUEST TO * 
►CONTROL PROGR AM*X • ■ 

* ■ READ 100 * 

* BYTES' * 



RNTYGO ^ X 

* SIM20 * 

CONTROL 
* PROGRAM * 



PREPARE CODE 
CONVERSION 
TABLE 



COMPUTE DATA 
LENGTH L FROM 
CSW RESIDUAL 
COUNT 



VALUE OF L 



LESS THAN 100 



»**F 2 ******* 

SET 
EXIT SWITCH 
TO 'EXIT' 



SET 
EXIT SWITCH 
TO • RETRY 1 



t**»G2 ******** < 
TRANSLATE 
INPUT DATA 
INTO 
INTERNAL CODE 



'INSERT 1 BIT 



RESET 
'INSERT' bIT 
TO ZERO 



•EXIT SWITCH 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



NOTE= THIS FLOWCHART IS ALSO VALID FOR 
THE ' READ TYPEWRITER' OPERATION. 
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Chart BM. Disk Operation Entry Routine 



*****C3**»»*»#*** 

* INITIALIZE » 
•SECTOR ADDRESS * 

,X*TO FIRST SECTQR*. 

* OF TRACK » 

* * 
*«-****«-*#*****#«* 



* * 

*SET UPPER LIMIT 
• X*OF SECTOR COUNT* 

* TO 20 * 

* « 
**#*****«-**«*« 



##»»»D2 *»»***♦ 
t » 

*SET UPPER LIMIT 
•OF SgCTQR CQUNT« 

* TO REQUEST * 

* COUNT * 
***•*»*##*»**** 



WLRC/RBC 
.REQUESTED. 



***»*g3**»»* 



»#»**»****#»* 



#»*»»F2 ***•*»#* 
» * 
*SET SWITCH FOR* 
*WLRC INDICATOR * 
* 'OFF' * 



READ DISK 



X *. OPERATION.* X 

***** *. .* **•*« 

*BP * *. .* *BQ * 

* 83* * * B3* 
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Chart BN. Seek Disk Operations 



CONVCW X 

*****B3********** 

* * 

* CONVERT * 

* 1620 DISK * 

* CONTROL FIELD * 

* * 
***************** 



SEEK X 

**»**C3* ********* 

* REQUEST A * 

* SEEK COMMAND * 

* FROM THE * 
•CONTROL PROGRAM* 

* * 
***************** 



SIM20 
CONTROL 
PROGRAM 



TERMINATION 



SKSN 

***»*»£ 4*# ******! 

SEND MESSAGE 
ABNORMAL* AND SET • STOP 1 

X BIT TO ONE 

* ( MANUAL MODEH 



************* 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



SIM20 



Chart BP. Read Disk Operations 




fr****B 3** ******* 

* CONVERSION OF 
» 1620 DISK 

* CONTROL FIELD 



DISRMH X 

*****C3********** 
•COMPARE SECTOR * 
» ADDRESS TO * 

, ..X*ADDRESS STORED * 
*IN 21ST RECORD * 
* OF TRACK » 
***************** 



* INCREMENT * 
►SECTOR ADDRESS* 



SECTOR 
ADDRESSES 
. COMPARE . 



*****E3**** ****** 

♦REQUEST A READ * 
* COMMAND FROM * 
♦CONTROL PROGRAM* 



SET * 
1620 * 
CORRESPONDI NG 
INDICATOR ON * 



RETURN TO 
BASIC INTERPRETIVE 
ROUT I NE 



.* HAS *. 

►LAST SECTOR*. 

HAS BEEN . 
*. READ .* 



SIM20 
CONTROL 
PORGRAM 



RETURN TO 
BASIC INTERPRETIVE 
ROUT I NE 



*MOVE DATA FROM * NORMAL 
*BUFFER TO 1620 »X........ 

» CORE STORAGE * 



************* 



ABNORMAL 



TERMINATION 



.* 162 *. 
•DISK OR I/O*. 

INDICATORS 
». CONCERNED.* 



* SEND MESSAGE 
AND SET 'STOP' 
* BIT TO ONE < 
(MANUAL MODE) 



UPDATE 1620 
DISK OR I/O 
INDICATORS 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 
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Chart BQ. Write Disk Operations 



CONVERSION OF 

1620 DISK 
CONTROL FIELD 

ft************** 



DISRMH X 

**»**C3 ********** 

* COMPARE * 
♦SECTOR ADDRESS * 

. .X*T0 ADDRESSES OF* 
*21ST RECORD OF * 

* TRACK * 
***************** 



SECTOR 
ADDRESSES 
. COMPARE . 



***»*E3** ******** 

♦MOVE DATA FROM * 

♦ 1620 CORE ♦ 

♦ STORAGE TO ♦ 

♦ BUFFER ♦ 
***************** 



WLRIND 

*****D4******* 

* SET * 

* 1620 * 
...X* CORRESPONDING 

* INDICATOR ON * 



»*•• 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



*««»*F2******* 
ft * 

» INCREMENT * 
ft 

►SECTOR ADDRESS* 
ft * 
»****•«*«***«* 



♦REQUEST A WRITE* 
♦ COMMAND FROM * 
♦CONTROL PROGRAM* 

***************** 



SIM20 
CONTROL 
* PROGRAM 

*********** 



ENDIS2 
YES 



***** 
*BA * 
* C2* 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



.* HAS *. 

•LAST SECTOR*. 

BEEN 
*. WRITTEN .* 



.* *. .* 1620 *. 

.* *. ABNORMAL .*DISK OR I/O*. 

► . TERMINATION .* X*. INDICATORS . 

*. .* * . CONCERNED. * 



*****J3******* 

* UPDATE 1620 
.* DISK OR I/O 

* INDICATORS 

* « 
************** 



EXCR3 

****»*H5 ********* 
SEND MESSAGE 
* AND SET 

...X 'STOP' BIT 

TO ONE (MANUAL* 
MODE) 
************* 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



Chart BR. Check Disk Operations 




CONVCW X 

■»*»»*B3********** 

* CONVERSION OF * 

* 1620 DISK * 

* CONTROL FIELD * 

* * 
***************** 



DISRMH X 

*****C3********** 

♦COMPARE SECTOR * 

* ADDRESS TO * 

. ..X* ADDRESSES * 

♦STORED IN 21ST * 

*RECD. OF TRACK * 



SECTOR 
ADDRESSES 
. COMPARE . 



WLRIND 

*****D4******* 

* SET » 

* 1620 * 
...X* CORRESPONDING 

* INDICATOR ON * 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



►LAST SECTOR* 

HAS BEEN 
«•• CHECKED .* 



'REQUEST A READ * 
* COMMAND FROM * 
♦CONTROL PROGRAM* 



SET 1620 * 
CORRESPONDING 
INDICATOR ON * 



►COMPARISON 
IS 

►SUCCESSFUL. 



SIM20 
CONTROL 
PROGRAM 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 



t««*G2******** 
COMPARE DATA 
IN BUFFER TO 
DATA IN 1620 
CORE STORAGE 



TERMINATION 



ABNORMAL .1620 DISK OR*. 

X*I/0 INDICATORS. < 

♦ • CONCERNED. ♦ 



****G5***^**^*« 

SEND MESSAGE 

AND SET 
•STOP' BIT TO 
* ONE ( MANUAL * 
MODE) 



UPDATE 1620 
DISK OR I/O 
INDICATORS 



RETURN TO 
BASIC INTERPRETIVE 
ROUTINE 
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EDITOR 



EDITOR is an independent program used to 
create a symbolic version of SIM20, adapted 
to the particular 1620 system being simu- 
lated, and to the System/360 model on which 
SIM20 is to be run (see Charts CA and CB) . 

Using information from control cards, 
EDITOR extracts from the symbolic SIM20 
tape distributed by IBM those routines 
needed to simulate a given 1620 system. 
Five types of control cards are used by 
EDITOR: 



• CPU1 



CPU 2 



defines the 
simulated. 



1620 CPU to be 



defines the corresponding 
System/360 CPU. 



• FEATURE defines a 1620 special or 

optional feature to be simu- 
lated. 

• DEVICE defines a 1620 I/O device to 

be simulated and a correspond- 
ing System/360 I/O device. 

• START indicates the end of the con- 

trol card deck and begins the 
editing process. 



OVERALL LOGIC OF EDITOR 

The following steps give the overall 
logic of EDITOR and follow the logic shown 
in Charts CA and CB. 

1. Control cards are read, one at a time, 
and the control information is used to 
build up a table of arguments, later 
used to select routines from the sym- 
bolic SIM20 tape. 



2. When the START card is encountered, 
processing begins; EDITOR checks the 
compatibility of: 

a. CPU1 and CPU2 cards, to ensure 
that the 1620 defined in the CPU1 
card can be simulated on the 
System/360 defined in the CPU2 
card 

b. FEATURE and CPU2 cards, to ensure 
that the optional or special fea- 
tures defined in the FEATURE card 
can be simulated on the System/360 
defined in the CPU2 card 

c. DEVICE cards and the table of 
accepted devices contained in EDI- 
TOR 

When an incompatibility is found, a 
message is sent to the operator 
requesting him to enter two correct 
control statements or to resume the 
editing process. 

3. The SIM20 version of CONTPR is written 
on the output device. 

H. EDITOR then builds up the CCBS and 
UCBs from the information in the 
DEVICE control cards, selects routines 
from the SIM20 tape according to the 
table of arguments, and writes the 
selected routines on the output 
device. 

5. When the end of the SIM20 tape is 
reached, a message is sent to the 
operator requesting him either to stop 
the editing procedure or to provide 
new control cards. 

6. The SIM20 tape is then rewound, ready 
for the next editing run. 
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Chart CA. Logic of EDITOR (Part 1) 



' EDITOR * 

t * 
►INITIALIZATION * 
t * 
t**************** 



* ***C2 ******** 

READ A 
•►CONTROL CARD 



E2 *. 
•* CPU1. *. 
» CPU 2 9 

FEATURE OR 
»• DEVICE 
♦.CARD .* 

"**NO 



CP1 
CP2 
FEAT 1 
DEVI 



***E3********* 

* PREPARE 

<* CORRESPONDING 

* TABLE OF 

* ARGUMENTS 
**************** 



t***Fl*****»*« 

SEND MESSAGE 
• INVALID 
CONTROL 
►INFORMATION 1 



IS IT fl 
START 
CARD 



.* CONTROL *. NO * SEND ERROR * "REQUEST TWO NEW* * PROCESS * 

INF. .* X ........X CONTROL CARDS X* THESE CONTROL * 

•COMPATIBLE.* * MESSAGE * *FROM OPERATOR* * CARDS * 

*. .* * * 

*. .* ************* ************* ***************** 
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Chart CB. Logic of EDITOR (Part 2) 



»***B2 ********* 

COPY ABSOLUTE 
LOADER FROM 
INPUT ONTO 
f OUTPUT * 
FILE 



*»***C2 *********** 

COPY SIM20 
•CONTROL PROGRAM* 
FROM INPUT 
* TO OUTPUT * 
FILE 



MESSAGE 
■END OF 
SIM20 ■ 



CTP1U X 

**»**Q2 ******** 

* BUILD UP 
♦CCB'S AND UCB' 

* ON OUTPUT 

* FILE FROM 

* ARGUMENTS 



.* ANOTHER 
FILE 
* • REQUESTED • 



FILE 
IS ON 



►**E2»****** 

READ 
FOLLOWING 
SECTION OF 
INPUT 
FILE 



REWIND 
INPUT 
FILE 



ARGUMENT 
PRESENT 
•IN TABLE 



MESSAGE 
•END OF 
EDITING" 



»***G2 *********** 

COPY SECTION * 
ONTO 
* OUTPUT FILE * 



WAI T 
******** 



END OF 
INPUT 
FILE 



YES 

**** 

* * 
.X* C4 * 

* * 
**** 



Editor 



DSKINT 



DSKINT is automatically edited by EDITOR 
when a 1620/1311 system is requested in 
control information. The output file of 
EDITOR contains both SIM20 and DSKINT in 
symbolic format. After assembly, the 
binary deck obtained is self-loading and 
immediately gives control to DSKINT. 



LOGIC OF DSKINT 

DSKINT (see Chart DA) : 

1. Sets the device address of the 
System/360 devices used by SIM20. 

2. Relocates the non-disk I/O simulation 
routines when the special disk- 
resident version of SIM20 has been 
requested. 

3. Requests from the operator the address 
of the 2311 Disk Storage Drive which 
must be initialized (the disk ad- 
dresses given by the operator are 
checked to ensure that they conform to 
the UCBs in SIM20) . 

4. Requests from the operator whether the 
disk formats are to be set up on the 
2311 Disk Storage Drives. If they 
are, the program writes the home 
address, the record 0, and 21 records 
on the 2311. The first 20 records 
correspond to the 20 sectors of the 
1311 and contain the System/360 iden- 
tification followed by 105 data bytes 
(5 for the address, 100 for data); the 
100 data bytes all contain X'FO'. 
Sector addresses are numbered succes- 
sively from 00000 through 19999. 

The last, or 21st, record summariz- 
es sequentially the preceding 20 
addresses (for example, for track 0, 
cylinder 0, the 21st record contains 
sector addresses 00000, 00001, 00002, 
. . .00019) . 

5. Requests from the operator whether 
SIM20 is to be loaded from System/360 
main storage. Ii so, it is loaded 
onto cylinders 00, 01, and 02, in the 
following manner: 

a. The first track of cylinder 00 is 
an IPL track, and the following 
tracks contain parts of SIM20 (CPU 
and console simulation routines) . 

b. Cylinder 01 is loaded with the I/O 
simulation routines (other than 
those for disks) . 



c. Cylinder 02 is loaded with the 
disk simulation routines. 

6. Signals the end of these two opera- 
tions by messages END OF FORMAT and 
END OF LOADING, and then branches back 
to step 3. 

Note: An exceptional condition not cleared 
by . an error recovery procedure places the 
System/360 in the wait state. Operator 
commands such as END or NO in response to 
the message SIMULATOR LOADING NEEDED also 
place the System/360 in the wait state. 

Loading SIM20 onto disk in a self- 
loading format is necessary when the user 
has defined a 1620/1311 system when editing 
SIM20. The DSKINT binary card deck, though 
it contains SIM20, cannot give control 
directly to SIM20. A SIM20 run can be 
started only by an IPL from the disk unit. 

Formatting is necessary when the disk 
storage drive must be used to simulate a 
1620/1311 system. Formatting is not 
necessary when the disk storage drive is 
used only as SIM20 residence. 



BUFFERS AND TABLES 

DSKINT contains three buffers: 

1. An input/output buffer IOBUFF, used to 
write messages or to enter commands 

2. A 3,400-byte buffer located at address 
X'6000*, used to load the CPU and 
console simulation routines onto cyl- 
inder 00 

3. A 2,100-byte buffer located at address 
X*6E00', used to load the disk simula- 
tion routines onto cylinder 02 (no 
buffer is necessary to load the other 
I/O simulation routines onto cylinder 
01) 

The program also contains two blocks of 
main storage : 

1. A field for each sector, containing: 
The home address (4 bytes) 

The record (1 byte) 

The key length (1 byte — always =0) 

The data length (2 bytes — always = 

105) 

The data field (105 bytes) 

2. An IPL field containing the IPL 
sequence for 2311 Disk Storage Drives 
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Chart DA. DSKINT 



ft*fr##*Bl**»******** 

MESSAGE TO 
•REQUEST ADDRESS* 
OF DISK UNIT > 
TO BE PROCESSED 



.* OPERATOR 
*. REPLY 



» C3 »... 

* * • 

• ••* . 

NOFORM X 

MESSAGE TO 

* REQUEST IF * 

SIM20 

* LOADING IS » 

NEEDED 
***•»*#•***•* 



A6A X 

*##*»* 01*********** 

MESSAGE TO . 
•REQUEST WHETHER* 
FORMAT IS 
» NEEDED • 



*#»»D2 **»»#♦*** 
ft « 
» WAIT « 

ft * 

»#»»»»****#»#** 



t* OPERATION *. 
'*. REPLY .»" 



•X* C3 * 
• * 
»••« 



INI21 X 

•**#««E3**** *••**•« 
CONSOLE AND CPU 
* SIMULATION * 
ARE LOADED ON 
»T0 CYL IN* 00 » 
WITH IPL 
*»**»#**»#*»* 



ft»»«»»F 1 ••••*•••••« 

WRITE 
• HOME ADDRESSES »• 
RO AND 
» SECTOR • 
IDENTS. 
•••••**•••«•• 



»»»»»»F3* 

NON DISK I/O 
» SIMULATION 
IS LOADED ONTO 
• CYLINDER 01 « 

••••••••••••• 



»••••••• 



MESSAGE TO 
SIGNAL END 
OF FORMAT 



. •••• 
• • • 
..X» C3 • 



»»»»*»G3»»*»****»»* 

DISK SIMULATION 
» IS LOADED • 
ONTO CYLINDER 



••*•*«***•*•« 



MESSAGE » 
•END OF 
» LOADING' • 

••••••»••*•»« 

• •**• 

• • * 
..X* Bl • 

* « 
»*•• 



DSKINT 
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UPDT20 



UPDT20 (see Chart EA) reads from the 
device with symbolic name UPDTOLD a version 
of the Simulator system tape to be correct- 
ed, makes the corrections indicated in the 
information read from the device with sym- 
bolic name UPDTCORR, and writes the cor- 
rected version of the system tape on the 
device with symbolic name UPDTNEW. 

To simplify the presentation, this de- 
scription refers only to a system tape, but 
it is also valid when the Simulator is on 
punched cards . 



LAYOUT OF THE SYSTEM TAPE 

The system tape on UPDTOLD is made up of 
several files: 

• A file contains one or several modules 
which, in turn, contain one or several 
records. 

• Each file is followed by a tape mark. 

• The end of the system tape is indicated 
by two tape marks . 

Note: When the Simulator is distributed on 
cards, the card deck contains only one file 
composed of several modules. 



IDENTIFICATION OF SYSTEM TAPE COMPONENTS 

The three components of the system tape 
are identified as follows: 

• A file is identified by the identifi- 
cation of its first module. 

• A module is identified by the identifi- 
cation of its first record. 

A module is composed of all the 
consecutive records having the same 
identification in columns 73 through 75 
for symbolic card- image records, or in 
columns 73 through 76 for binary card- 
image records. 

• A record is identified by its serial 
number in columns 77 through 80 for 
binary records, or in columns 76 
through 80 for symbolic records. 

Record numbers in each module must 
be in ascending order. 

The identification of system tape compo- 
nents is illustrated in Table 5A. 



Table 5A. Identification of Simulator Sys- 
tem Tape 



r t t t 1 

I FILES | MODULES | RECORDS | COMPONENTS | 

,. + + 1 ^ 

| A21B | A21B | A21B0001 | COMMON SUB- | 
| | | A21Bnnnn | PROGRAMS | 
, |. 1 ) , 

| | A22B | A22B0001 | composed of | 

j I | A22Bnnnn j modules: j 

| |- 1 -| A21B A.22B j 

| | . | . | A23B A24B j 

J | . | | A25B A26.B | 

, v — : — + — : — 4 i 

j I A26B | A26B0001 | LDT card | 
,. + + 1_ .J 

| TM | | | Tape mark | 
y + + + 4 

j A2UB | A2UB | A2UB0001 |UPDT20 j 
j j | A2UBnnnn | j 
, |. + .j | 

| j A27B | A27B0001 | LDT card | 
j. + + - + ) 

| TM | | | Tape mark | 

I- + + +— "I 

j A2EB | A2EB | A2EB0001 | EDITOR | 
j j | A2EBnnnn j j 

Y + + + -I 

j TM | | | Tape mark | 
y + + + ^ 

| A2ZB | A2ZB | A2ZB0001 | SYSINEND | 
|. + + 1 ) 

| TM | | | Tape mark | 
y + _ + + ^ 

j A2S | A2S | A2S00001 | SIM20 j 
j j j A2Snnnnn j j 
y + + + ^ 

j TM | | | Tape mark | 
y + + + ^ 

| A2P | AP2 1 | A2P00000 | SAMPLE PRO- j 
| | | 1 1 GRAM | 

i- + + + ^ 

j TM | | | Tape marks | 
| TM j | j Data end j 
|. ± ± j. ^ 

| 1 Identif ication field not significant. | 

L J 



UPDATING FUNCTIONS 

Updating can be done at file level, at 
module level, or at record level. For 
corrections at module or record level, the 
file containing the module or record to be 
corrected must first be defined. 
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The main updating functions are: 
Updating at File Level 

• Copy an old file onto UPDTNEW 

• Correct and copy an old file onto 
UPDTNEW 

Updating at Module Level 

• Copy an old module onto UPDTNEW 

• Replace an old module by a new one 
Updating at Record Level 

• Delete an old record or a set of 
consecutive records 

• Insert a new record or a set of conse- 
cutive records 

• Replace an old record or a set of 
consecutive records by a new one 

• Re-number a set of consecutive records 

Note: All undefined records are copied 
without modification. 

Other updating functions such as delet- 
ing, inserting, and listing all or only the 
corrected modules on UPDTNEW at file level, 
or deleting, inserting, re- numbering, and 
re-identifying a module at module level, or 
re-identifying a record or a set of conse- 
cutive records at record level, are 
explained in detail in the listing of the 
UPDT20 program supplied with the Program 
Logic Manual. 



Since correction cards are not sorted by 
the program, the seguence of the files, 
modules, and records reguired for correc- 
tion must exactly correspond to the 
seguence of the files, modules, and records 
of the tape distributed by IBM. Any cor- 
rections the user may receive will be in 
the correct order. 



Control Cards 

Three types of control card are used for 
the main updating functions. 

• The / UPDATE card defines the old file 
to be corrected or copied onto UPDTNEW. 
If this control card has not been 
specified for an old file, this file is 
ignored by UPDT20. 

• The RIS mode C card defines each module 
to be replaced in the file defined by 
the / UPDATE card. 

• The RIS mode R card defines the record, 
or set of consecutive records, to be 
corrected in the file defined by the 
/ UPDATE card. 



Modification Cards 

The modification cards contain the 
replacement data for the new modules or the 
insertion or replacement data for the new 
records to be written on UPDTNEW. 

The identification in columns 73 through 
75, or in columns 73 through 76 is that of 
the module defined in the corresponding RIS 
card. 



UPDATING THE SYSTEM TAPE 

The correction data used to update the 
system tape may be on cards or on tape. 
The correction cards (or card images) 
reguired for UPDTCORR are divided into 
control cards and modification cards. 



Control Card Formats 

The format of the / UPDATE card is 
illustrated in Figure 9. The format of the 
RIS mode C card is given in Figure 10, and 
that of the RIS mode R card in Figure 11. 



Column 
1 3 
1 1 


15 18 
1 1 


T 

80 | 
I I 








/ UPDATE 




+ . 


Defines card as / 
card 


UPDATE 


control 




XXX 




Identification of 
module of the file 


first 


symbolic 




XXXB 




Identification of 
module of the file 


first 


binary 



Figure 9. Format of the / UPDATE Card 
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Column 






T 


12 8 
1! 1 


41 44 
1 1 


80 
1 


_ + 


♦RIS 


C 

R 




| Defines card as RIS mode C card 
j C = mode C 

| R = replace module 


XXX 






| Identification of module to be re- 


XXXB 






| placed (same for old and new module) 


* = 12-2-9 punch 
Note: This card is 


required only for modules 


to 


be replaced. 



Figure 10- Format of the RIS Mode C Card 



Column 

12 8 24 41 59 
II I 1 II 


T 

67 80 | 
1 1 1 




♦RIS 


+- 


Defines card as RIS mode R card 
Column 44 must be blank. 


XXXnnnnn 
XXXBnnnn 




Identification of first old record 
to be replaced, deleted, or re- 
numbered, or the record after which 
the first new record is to be in- 
serted 


XXXnnnnn 
XXXBnnnn 




Identification of last old record 
to be replaced, deleted, or re- 
numbered 


R 
I 

s 

N 




Replace 
Insert 

Suppress (delete) 
Re- number 


nnnnn 1 




Identification number required for 
first new record 




nn 1 j 

L 


Increment value of identification 


* = 12-2-9 punch 

1 Leading zeros can be ignored. 



Figure 11. Format of the RIS Mode R Card 
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CODING EXAMPLES 



The following examples show how the 
control cards should be punched to perform 
the updating functions described in the 
section "Updating the System Tape." 



1. 
2. 
3. 
4. 
5. 
6. 
7. 



/ UPDATE 
*RIS A2EB 



A21B 



*RIS 
*RIS 
*RIS 
*RIS 



A2S01230 
A2S01375 
A2S02300 
A2S08000 



R C 
A2S01240 

A2S02380 
A2S09810 



/ UPDATE 
/ UPDATE 
/ UPDATE 
*RIS A2EB 



A21B 
A2UB 
A2EB 



| new module (replacement cards) 
i 

/ UPDATE A2ZB 

/ UPDATE A2S 

*RIS A2S01230 A2S01370 

*RIS A2S03750 



j insertion cards 

L 



*RIS 



A2S02300 



A2S02380 



| replacement cards 
/ UPDATE A2P 
♦represents a multiple punch of 12-2-9 in column 1. 



01376 001 
02300 005 
10010 005 



3751 



02300 



001 



005 



Updating a File 

In example 1 above, file A21B is to be 
copied onto UPDTNEW with or without a 
modification at module or record level. 

Updating a Module 

In example 2, the whole binary module 
identified by A2EB is to be replaced. 

Updating a Record 

In example 3, records A2S01230 through 
A2S01240 of the file defined by the 
/ UPDATE card are to be deleted. 

In example 4 r new records are to be 
inserted after record A2S01375 of the file 
defined by the / UPDATE card. The iden- 



tification of the first new record is to be 
A2S01376; the numbering step is 1. 

In example 5, records A2S02300 through 
A2S02380 are to be replaced by a record or 
set of records. The identification of the 
first replacement record is 02300; the 
numbering step is 5. 

In example 6, records A2S08000 through 
A2S09 810 are to be re- numbered beginning 
with number 10010; the numbering step is 5. 

Updating the System 

Example 7 shows a sequence of correction 
cards used in updating the system tape. 
The first part covers updating the system 
tape and replacing module A2EB. The second 
part covers updating the system tape and 
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j deleting, inserting, replacing and re- 
I numbering records of file A2S. 



INITUP ROUTINE 

The INITUP routine initializes UPDT20 

by: 

• Reading the first record of the system 
tape on UPDTOLD and the first / UPDATE 
card 

• Transferring control to the File Pro- 
cessing routine (FLTGA) 



FILE PROCESSING ROUTINE (FLTGA) 

This routine selects the operations to 
be performed on a file. 

Entry Points ; The FLTGA routine has two 
entry points, first from the INIT routine, 
and then from the CSTGL routine after 
processing a file. 

Input : When the routine is entered, the 
first record of the system tape to be 
corrected (or the last tape mark on the 
tape) and a / UPDATE card (or the last of 
the correction cards) have been read. 

Operation; This routine analyzes the 
contents of the / UPDATE card and of the 
record, and transfers control to the rou- 
tine to perform the requested operation. 



Exits : Control is transferred to one of 
the routines NLSTP, SKLDM, SKCRDM, SKLDN, 
or CSTGB. When the routines SKCRDM, SKLDN, 
and CSTGB are entered, the last record read 
has been specified in the / UPDATE card. 

NLSTP Routine 

This routine is entered at the end of 
the run. It writes the last tape mark on 
the system tape on UPDTNEW. 

SKLDM Routine 

If the record just read has not been 
specified in the / UPDATE card, this rou- 
tine suppresses a file on the system tape 
on UPDTOLD. All the records on this system 
tape, up to the next tape mark, are sup- 
pressed; that is, they are not written on 
the system tape on UPDTNEW. Control is 
then transferred to the CSTGC routine (end 
of processing of a file) . 

SKCRDM Routine 

If the / UPDATE card is followed by a 
I modification card, this routine skips over 

the correction cards for a file. All the 
I modification and RIS cards following this 

/ UPDATE card are read, but not processed. 

Control is then transferred to the SKLDN 

routine. 

SKLDN Routine 

If the / UPDATE card is followed by 
another / UPDATE card or by no card at all, 
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this routine copies a file from the system 
tape on UPDTOLD onto the tape on UPDTNEW. 
The record just read, and all those that 
follow, up to the next tape mark, are 
copied onto the tape on UPDTNEW. Control 
is then transferred to the CSTGC routine 
(end of processing of a file). 



RISN Subroutine 

If the RIS card has specified the record 
just read, and if this RIS card is a mode C 
card, this routine replaces, inserts, sup- 
presses, or re- numbers an entire module. 
Control is then returned to CSTGA to pro- 
cess the next module in the file. 



MODULE PROCESSING ROUTINES 
(CSTGA AND CSTGB) 

These routines select the operations to 
be performed on a module (control section) , 
provided that the / UPDATE card is followed 
by an RIS mode C card. 



Entry Points; The CSTGB routine is entered 
from the FLTGA routine, and the CSTGA 
routine is entered from the routines 
SKCRDA, SKLDA, RISN (after an entire module 
has been processed), and RCTGB (after all 
the records in a module have been 
corrected) . 

Input; When the routine is entered, the 
first record of a module from the system 
tape on UPDTOLD (or a tape mark after all 
the modules in a file have been processed) 
and an RIS card (or a / UPDATE card or the 
last of the correction cards) have been 
read. 

Operation; The routine analyzes the param- 
eters in the RIS card and the contents of 
the first record of the module. Control is 
then transferred to the appropriate subrou- 
tine to process the module. 

Exit; When the module has been processed 
(when the program has encountered a tape 
mark on the system tape on UPDTOLD, a 
/ UPDATE card, or the last of the correc- 
tion cards on UPDTCORR) , control is trans- 
ferred to the CSTGC routine. 



SKCRDA Subroutine 

If the RIS card is invalid, this routine 
skips over the correction cards for the 
module. This card and all the MOD IF and 
RIS cards for this module are read, but not 
processed. Control is then returned to 
CSTGA to process the next module in the 
file. 



SKLDA Subroutine 

If the RIS card has not specified the 
record just read, this routine copies a 
module from the system tape on UPDTOLD onto 
the tape on UPDTNEW. Control is then 
returned to CSTGA to process the next 
module in the file. 



END OF FILE PROCESSING ROUTINE (CSTGC) 

This routine is entered from the rou- 
tines CSTGA, CSTGB, SKLDM, and SKLDN. It 
writes the end-of-file tape mark on the 
tape on UPDTNEW and transfers control to 
the FLTGA routine to process the next file. 



RECORD PROCESSING ROUTINE (RCTGB) 

This routine selects the operations to 
be performed on the records of a given 
module, provided that the RIS card has 
specified the record just read, and that 
the RIS card is a mode R card. 

Entry Points; This routine is entered from 
the CSTGA routine, and from the routines 
SKCRDA, SKLDB, and RISN. 

Input : When the routine is entered, a 
record of the module being processed (or 
the first record of the next module, or a 
tape mark after the last record of a module 
has been processed) and an RIS card refer- 
ring to this module (or an RIS card refer- 
ring to another module, or a / UPDATE card) 
have been read. 

Operation; This routine analyzes the pa- 
rameters of the RIS card and the contents 
of the record just read. Control is then 
transferred to the appropriate subroutine 
to process the record. 

Exit; When all the records in a module 
have been processed, control is transferred 
to the CSTGA routine to process the next 
module. 

SKCRDA Routine 

If the RIS card is invalid, this routine 
skips over the correction cards for a 
module. This RIS card and all the correc- 
tion cards for the module are read, but not 
processed. Control is then returned to 
RCTGB to process the next record. 

SKLDB Routine 

If the RIS card has not specified this 
record, this routine copies a record from 
the system tape on UPDTOLD. Control is 
then returned to RCTGB to process the next 
record. 
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RISN Routine 



If the RIS card has specified the record 
or records and if the RIS card is a mode R 
card, this routine replaces, inserts, sup- 
presses, or re- numbers a set of records. 
Control is then returned to RCTGB to pro- 
cess the next record. 
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Chart EA. Overall Logic of UPDT20 
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•FUNCTIONS TO BE* 
►EXECUTED IN THE* 
► OLD MODULE * 



* DETERMINE THE * 

* FUNCTIONS TO BE*X. 
•EXECUTED IN THE* 

* OLD FILE * 
*«•*•****•**•«*** 



.* END *. 
•OF OLD TAPE*. YES 

AND OF TAPE .*.... 
•CORRECTIONS* 



TERMINATE 
PROCESSING 
OF FILE 



END OF JOB 



.* ANY *. 

••CORRECTION *. NO 
^ .CARD FOR THE .*... 
*.OLD FILE .* 



.* ANY *. 

.* ERRORS IN 
f. CORRECTION 
*. CARDS . 



SUPPRESS 

THE 
OLD FILE 



* IGNORE THE * 
.X*CORRECTI ONS FOR* 

* THAT FILE * 

* » 
**»■»*»*»«******** 



.X* COPY OLD FILE 



.* END *. 

•OF OLD FILE* 

AND OF FILE 
•CORRECTIONS* 



.* ANY *. 

• ERRORS IN 
CORRECTION 
•. CARDS 



* IGNORE THE * 
•X*CORRECTIONS FOR* 

* THAT MODULE * 



.* MODULE TO * 
.BE CORRECTED 
*. FOUND .* 



.X*COPY OLD MODULE* 



.* ARE *. 
••CORRECTIONS*. N 
*. REQUIRED IN A.*. 
*. RECORD .* 



******* ******** 



* DETERMINE THE * 
.X*FUNCTIONS TO BE* 

•EXECUTED IN THE* 

* OLD RECORD * 



* IGNORE THE * 
.•CORRECTIONS FOR*X. 

* THAT RECORD * 



»*»F4*******« 

REPLACE OR 
INSERT OR 

SUPPRESS OR 
RENUMBER 
A MODULE 



•*END OF *. 

•OLD MODULE 

AND CORREC- 
•• TIONS . 
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CORRECTION 
». CARDS 



X..»COPY OLD RECORD*X. 



.* RECORD TO * 
».BE CORRECTED 
*. FOUND .* 



RISN 

*****K3******** 

* REPLACE OR 

* INSERT OR 
.» SUPPRESS OR 

* RENUMBER 

* A RECORD 
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ABSOLUTE LOADER (ABSLOD) 

ABSLOD is used to load the following 
subprograms into the System/360 storage 
locations assigned by the assembler (see 
Chart FA) : 

• CONTPR 

• IOPACK 

• INIT 

• RELLDR 

ABSLOD also accepts assembled programs 
intended to be loaded by a relocating 
loader, but with the limitations given in 
the section "Additional ABSLOD Functions." 

ABSLOD is used to load the assembled 
SIM20 and DSKINT programs. 



ABSLOD CARDS AND FUNCTIONS 

Five types of load card are recognized 
by this loader: TXT and END cards which 
were generated by the assembler, any REP 
cards which may be inserted by the user, 
and the LDR and LDT cards which were 
supplied by the IBM programmer. The load 
cards of the subprograms listed above have 
been converted, in the correct order, to 
card images on magnetic tape and form the 
first portion of the Simulator system tape. 

The functions of ABSLOD and the cards 
associated with each function are listed in 
Table 6. 

Card Sequence 

Each subprogram, or control section, in 
the Simulator system tape includes at least 
two types of card: TXT and END, in that 



order. The LDR card is placed between the 
END card of IOPACK and the first card of 
INIT. The last card in the deck is an LDT 
card. 



If the user wants to make any changes in 
the assembled program, he must insert the 
appropriate REP cards after the last TXT 
card of the control section concerned and 
before the END card. 



As each TXT or REP card is read, ABSLOD 
places the contents of the card in storage 
at the absolute address given in that card; 
therefore, the addresses in the cards need 
not be in increasing order of value. It is 
also possible to overlay a section which 
has already been loaded. 



The value of the highest address loaded 
is recorded by the loader in a location 
counter (LOCCTR) . Each time the location 
counter is incremented, its value is 
checked to make sure that the loader pro- 
gram is not overlaid. If it is, loading is 
interrupted and the System/360 enters the 
wait state. 



Card Formats 

Values in load cards produced by the 
assembler are represented in IBM extended 
card code; for example, the decimal value 
20 (represented in one byte as 0001 0100) 
becomes an 11-9-4 punch in one card column. 

In contrast, the programmer uses the 
more convenient hexadecimal code if REP 
cards are used. The hexadecimal equivalent 
of decimal 20 is 14; this is a 1 punch and 
a 4 punch in two successive card columns, 
representing the contents of one byte. 



Table 
r 



6. ABSLOD Functions 



FUNCTIONS 



CARDS 



Loading : Places the instructions or constants, or both, of a 
control section into the storage locations assigned by the 
assembler. 

Correcting : Allows changes to be made to the instructions or 
constants in the program at load time. 

Transferring Control : Ends loading of the control section and 
transfers control to some location within the section. 



Text (TXT) 



Replace (REP) 



Load End (END) 
Load Terminate 



(LDT) 



j 
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Text Card 

The Text (TXT) card is generated by the 
assembler and contains, in IBM extended 
card code, the following: 

1. The address at which the assembled 
instructions and constants in the card 
are to be inserted 

2. The number of bytes of information 
contained in the card 

3. The text itself, up to a maximum of 56 
bytes 



The programmer cannot replace a two-byte 
instruction by a four-byte instruction 
through the load program. Instead, he must 
either re-assemble his source program or 
patch; that is, replace the incorrect or 
old entry with a branch instruction to some 
storage location into which the replacement 
will be loaded. Replacement must be made 
byte for byte. 



The contents of the REP card fields are 
defined in Table 8. 



The contents of the TXT card fields are 
defined in Table 7. 



Table 7. Text Card 

r t 

I COLUMN I 



CONTENTS 



Load card identification 

(12-2-9 punch) . Identifies 
this as a card acceptable to 
the loader. 



2-4 

5 

6-8 

9-10 
11-12 

13-14 
15-16 

17-72 
73-80 



TXT. Identifies the type of 
load card. 

Blank . 

The address, in extended card 
code, at which the information 
on the card is to be loaded. 

Blank . 

Number, in extended card code, 
of bytes of text in the card. 

Blank. 

Information for RELLDR. The 
contents of these columns is 
ignored by ABSLOD. 

From 1 to 56 bytes of text 
(instructions or constants 
assembled in extended card 
code) . 

Not used by the loader. 



Table 8. Replace Card 

CONTENTS 



r t- 

I COLUMN I 



-+- 



2-4 

5-6 
7-12 



13-16 



17-70 



71-72 
73-80 



Load card identification 

(12-2-9 punch) . Identifies 
this as a card acceptable to 
the loader. 



REP. Identifies 
load card. 

Blank. 



the type of 



Address, in hexadecimal, of the 
area to be replaced. It must 
be right- justified in these 
columns. Unused leading 

columns are filled with zeros. 
The address must specify a 
half-word boundary. 

Blank. 

A maximum of eleven 4-digit 
hexadecimal fields, separated 
by commas, each replacing one 
previously loaded half-word 
(two bytes) . The last field 
must not be followed by a 
comma . 

Blank. 

Not used by the loader. 



Replace Card 

Replace (REP) cards are supplied by the 
programmer and must be placed in the con- 
trol section immediately after the last TXT 
card. Assembled instructions or constants, 
or both, are replaced byte for byte by the 
instructions or constants punched in the 
card in hexadecimal code. A REP card may 
contain a minimum of two bytes (one 
half-word) and a maximum of 22 bytes. 



Load End Card 

The Load End (END) card is generated by 
the assembler when it encounters the END 
instruction. This card ends the loading of 
a control section and may specify a loca- 
tion within the section to which control is 
to be transferred. 

The contents of the END card fields are 
defined in Table 9. 
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Table 9 . Load End Card 

CONTENTS 



r t- 

I COLUMN | 



— 1 



I" 



Load card identification 

(12-2-9 punch) . Identifies 
this as a card acceptable to 
the loader. 



2-4 



6-8 



9-14 
15-16 

17-72 
73-80 



END. Identifies 
load card. 

Blank . 



the type of 



Address (may be blank) , in 
extended card code, of the 
point in the control section to 
which control may be trans- 
ferred at the end of the load- 
ing process. See the priority 
conditions discussed under the 
LDT card. 

Blank. 

Information for RELLDR. The 
contents of these columns is 
ignored by ABSLOD. 

Blank. 

Not used by the loader. 



is used as a return address to INIT at 
the end of ABSLOD. 

4. RELLDR END card 

The entry point in RELLDR, speci- 
fied in this card, is stored in 
System/360 main storage. It is used 
as a return address to RELLDR at the 
end of INIT. 



LDR Card 

Of the four other subprograms included 
in the Simulator system tape, two (CONTPR 
and IOPACK) are designed to reside perma- 
nently in storage with whatever other pro- 
gram is being used: EDITOR or UPDT20, and 
are therefore loaded starting at address 0. 
The two other subprograms (INIT and RELLDR) 
are used only to load and initialize the 
Simulator programs; thereafter they are 
overlaid. These two subprograms are there- 
fore loaded into storage after address 
56000. 

The LDR card, which is placed immediate- 
ly after IOPACK, terminates incrementing of 
the location counter (LOCCTR) at this 
point, so that the Simulator programs may 
be loaded from this address onwards. The 
location counter is therefore not incre- 
mented when INIT and RELLDR are loaded. 



Processing of END Cards by ABSLOD 

When an END card is found by ABSLOD, 
parameters pertinent to this card are 
stored in System/360 main storage, then 
transferred to registers or return address- 
es when an LDT card is found. 

Four types of END Cards may be found by 
ABSLOD: 

1. CONTPR END card 

The address of the last byte of 
CONTPR, which is contained in the 
location counter, is stored in 
System/360 main storage. When an LDT 
card is found, this address is stored 
in System/360 general register 2. 

2. IOPACK END card 



The contents of the LDR card fields are 
defined in Table 10. 



Table 10. LDR Card 

r t 

COLUMN I 




CONTENTS 



Load card identification 

(12-2-9 punch). Identifies 
this as a card acceptable to 
the loader. 

LDR. Identifies the type of 
load card. 

Blank. 

Not used by the loader. 



j 



The address of the byte following 
IOPACK, which is contained in 
LOCCTR+1, is stored in System/360 main 
storage. When an LDT card is found, 
this address is stored in System/360 
general register 1. 

3. INIT END card 

The entry point in INIT, specified 
in this card, is stored in a PSW. It 



Load Terminate Card 

The Load Terminate (LDT) card is placed 
at the end of the input deck. It has two 
uses: 

1. It ends the loading process. 

2. It causes control to be transferred to 
some location within the section or 
sections loaded. 
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The location to which control is trans- 
ferred is determined according to the fol- 
lowing order of priority: 

1. Control is always transferred to any 
location specified in the LDT card. 

2. If the LDT card does not specify a 
location, control is transferred to 
the first location specified by an END 
card encountered during the current 
loading process. 

3. If neither the LDT card nor any END 
cards specify a location, control is 
transferred to location 0, resulting 
in an error halt. 

The contents of the LDT card fields are 
defined in Table 11. 



Table 11. Load Terminate Card 

r t i 

| COLUMN | CONTENTS | 



1 


i 

| Load card identification 
j (12-2-9 punch) . Identifies 
j this as a card acceptable to 
j the loader. 


2-4 


j LDT. Identifies the type of 
j load card. 


5 


j Blank . 


6-8 


j Address (may be blank) , in 
j extended card code, of the 
j point in the program to which 
j control is to be transferred. 


9-72 


1 Blank . 


73-80 


j Not used by the loader. 

-X 



The LDT card at the end of RELLDR is 
blank and control is transferred to the 
address specified in the END card at the 
end of INIT. 

ABSLOD prepares the following data in 
the general registers for INIT: 

• The address of the last byte of CONTPR 

• The current value of the location 
counter 

• The address in RELLDR to which control 
must be transferred when initialization 
is completed 

ABSLOD initializes the machine-check and 
program- check new PSWs to cause the 
System/360 to enter the wait state if a 
machine check or a program check occurs. 
Before loading, ABSLOD also sets core stor- 



age to zero from location X*180* (384 
decimal) to the end of storage, except for 
the area occupied by ABSLOD. 

After control is transferred to the 
loaded program, the Simulator operates in 
the problem state, disabled for all inter- 
ruptions except machine check or program 
check until the PSWs for these interrup- 
tions are altered by the programs loaded. 



ADDITIONAL ABSLOD FUNCTIONS 

ABSLOD also accepts assembled programs 
intended to be loaded by a relocating 
loader, but with the following limitations: 

1. Cards of other types than those listed 
above (SLC, ICS, ESD, and RLD) are 
ignored, as is any information on TXT, 
REP, and END cards meaningful only to 
RELLDR. 

2. Control sections are not linked. 
Should one control section refer to 
instructions or data in a section 
assembled separately, absolute ad- 
dresses are used. 



CONTROL PROGRAM (CONTPR) 

CONTPR (see Chart FB) is used by EDITOR, 
UPDT20, and, in a reduced form, by SIM20 
and DSKINT. To simplify the presentation, 
this description refers only to EDITOR, but 
is valid for all the programs. When a part 
of CONTPR is not used by SIM20 and DSKINT, 
it is so stated. 

CONTPR consists of routines to: 

• Process machine-check interruptions 

• Process supervisor-call interruptions 

• Process program interruptions 

• Process I/O interruptions 

• Verify the characteristics of I/O de- 
vices 

• Process I/O requests 

• Set up the standard SEREP interface 

• Communicate with the 1052 Printer- 
Keyboard 

CONTPR operates in the supervisor state, 
whereas EDITOR operates in the problem 
state. Any attempt to execute a privileged 
instruction within EDITOR causes a program 
interruption. 
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INTERRUPTION PROCESSING 

Machine-Check Interruptions 

When a machine- check interruption oc- 
curs, CONTPR is entered. It responds by 
setting up the standard SEREP interface for 
a machine check. 

Supervisor-Call Interruptions 

Supervisor- call (SVC) interruptions are 
processed by means of an SVC table of 20 
full-word entries corresponding, in order, 
to the allowed values (0 through 19) of the 
interruption code in an SVC instruction. 
These codes and their corresponding 
functions are given in Table 12. 

If the interruption code is greater than 
19, a program interruption is artificially 
created; the . interruption code portion of 
the program old PSW is set to indicate an 
operation exception. Otherwise, control is 
passed to the appropriate routine via the 
SVC table. 

For most of its functions, CONTPR must 
be given a number of parameters, whose 
values are set up in the bytes immediately 
following the SVC instruction. An SVC 
instruction, together with its necessary 
parameters, is referred to as an SVC call- 
ing sequence. 

The general and floating-point registers 
may contain any value when an SVC calling 
sequence is presented to CONTPR. When 
control is returned to EDITOR, the contents 
of these registers remain unchanged. 

Only the SVC instructions with interrup- 
tion codes 1, 2, 3, 7, 8, and 9 are used by 
SIM20 and DSKINT. 

Program Interruptions (SVC 6) 

When a program interruption occurs, 
CONTPR is entered. 

When CONTPR is loaded into System/360 
main storage, program interruptions are 
processed in the following way: 

1. A PSW is loaded, for which I/O and 
external interruptions are enabled, 
and in which the wait state bit is one 
and all the interruption code bits are 
z eros . 

2. The wait light on the system control 
panel is turned on, and, except when 
processing I/O and external interrup- 
tions, operator intervention is await- 
ed. 



Table 12. SVC Table 



SVC 
CODE 


i 

.1. 


FUNCTION 





i 


I/O device verification 1 


1 


j 


Submit an I/O request and inter- 
rupt at channel end 2 


2 


j 


Submit an I/O request and 
continue 2 


3 


i 


Return to the point of interrup- 
tion 


4 


i 


Write a message 1 


5 




Set command parameter s 1 


6 


j 


Set return address for a program 
interruptions- 


7 
8 


! 
1 


Set up SEREP interface 

Disable I/O and external inter- 
ruptions 


9 


j 


Enable I/O and external inter- 
ruptions 


10 


! 


Set return address for an exter- 
nal interruptions- 


11 


I 


Submit an I/O request and wait 1 


12 


! 


Dump System/360 main storage 1-2 


13 


1 


Rewind a specified 2400-Series 
Magnetic Tape Units- 


14 


! 


Rewind and unload a specified 
2400-Series Magnetic Tape Units- 


15 


1 


Disable console (ignore atten- 
tion interruptions) 1 


16 


| 


Enable console (accept attention 
interruptions) 1 


17 




Set parameters for a logical I/O 
request to IOPACK 1 


18 




Submit a logical I/O request to 
IOPACK 1 


19 


i 


Set the wait state bit "on" in 
the current PSW 1 


1 These SVC codes are not used by SIM20 

and DSKINT. 
2 These SVC codes are not used by EDITOR 

and UPDT20. 
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The processing of subsequent program 
interruptions may be changed by submitting 
an SVC 6 calling sequence to CONTPR. This 
calling sequence has the following form: 



PRPSW 
1+14 



CNOP 
SVC 
DC 
DS 



2,8 

6 

A(PRRET) 
D 



Any instruction 



This SVC calling sequence is not used by 
SIM20 and DSKINT. 



Disable I/O and External Interruptions 
(SVC 8) 

The SVC 8 calling sequence causes I/O 
and external interruptions to be disabled; 
that is, the system mask is set to the 
value X'OO*. 



As a result of this calling sequence, 
when any subsequent program interruption 
occurs, the program old PSW is placed in 
the double-word with address PRPSW, I/O and 
external interruptions are disabled, and 
control is returned to EDITOR at address 
PRRET. 

This SVC calling sequence is not used by 
SIM20 and DSKINT. 



The disabled state may be set up either 
by the SVC 8 calling sequence or as a 
result of an interruption. 

Enable I/O and External Interruptions 
(SVC 9) 

The SVC 9 calling sequence causes I/O 
and external interruptions to be enabled; 
that is, the system mask is set to the 
value X'FF'. 



External Interruptions (SVC 10) 

When an external interruption occurs, 
CONTPR is entered. 

In the following cases, external inter- 
ruptions are ignored: 

• When CONTPR is loaded into System/360 
main storage 

• When an external interruption occurs 
because of an external signal 

In these cases, the external old PSW is 
loaded into the PSW. 

External interruptions related to the 
timer or to the interrupt key on the system 
control panel can be processed by submit- 
ting an SVC 10 calling sequence to CONTPR. 
This calling sequence has the following 
form: 



I 
I 
I 

EXTPSW 
1+18 



CNOP 

SVC 

DC 

DC 

DS 



6,8 

10 

A(TIlYilNT) 
A (KEY INT) 
D 



I/O DEVICE VERIFICATION (SVC 0) 

CONTPR verifies that the device at a 
given System/360 address is of the type 
"tttt" and has special features correspond- 
ing to "ss". The value of "tttt" and the 
bit structure of the special-features byte 
"ss" for the devices supported by CONTPR 
are presented in Table 13. 



The SVC calling 
following form: 

CNOP , 4 

I SVC 

DEV360 DC X'Oddd' 

TYPE DC C'tttt' 

FEATURE DC X'ss' 

DC AL3 (ERROR) 



sequence has the 



1+12 



Any instruction 



Any instruction 



If the device at System/360 address 
X'Oddd* corresponds to the device specified 
in the SVC calling sequence, control is 
returned to address 1+12; if not, control 
is returned to address ERROR. 

This SVC calling sequence is not used by 
SIM20 and DSKINT. 



As a result of this calling sequence, 
when any subsequent timer or interrupt-key 
interruption occurs, the external old PSW 
is placed in the double-word with address 
EXTPSW, I/O and external interruptions are 
disabled, and control is returned either to 
the instruction with address TIMINT (timer 
interruption) or to that with address KEY- 
INT (interrupt-key interruption) . 

If the value of TIMINT or KEYINT is 
zero, the interruption is ignored. 



I/O REQUESTS 

Three types of I/O request can be sub- 
mitted to CONTPR. These are: 

• I/O Request and Wait : CONTPR returns 
control to EDITOR only when all activi- 
ty related to the I/O operation has 
terminated. (This type of I/O request 
is not used by SIM20 and DSKINT.) 
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Table 13. Device Verification Table 



DEVICE TYPE 



SPECIAL- FEATURES BYTE 



1442 
tttt 



Card Read Punch 
= 1442 



Bit 7=0 No Card Image feature 
Bit 7=1 Card Image feature 



2501 
tttt 



Card Reader 
= 2501 



Bit 7 = 
Bit 7=1 



No Data Mode 2 
Data Mode 2 



2520 
tttt 



Card Read Punch 
= 2520 



Bit 7=0 
Bit 7=1 



No Data Mode 2 
Data Mode 2 



2540 
tttt 



Card Read Punch 
= 2540 



Bit 7=0 No Column Binary feature 
Bit 7=1 Column Binary feature 



1403 
tttt 



Printer 
= 1403 



Bit 7=0 100 print positions 
Bit 7=1 132 print positions 



1443 
tttt 



Printer 
= 1443 



Bit 7=0 120 print positions 
Bit 7=1 144 print positions 



2400-Series Magnetic 
Tape Unit 
tttt = 2400 



Bit 7=0 Nine-track tapes 

Bit 7=1 Seven-track tapes 

Bit 6=0 No data converter 

Bit 6=1 Data converter 

Bit 5=0 Seven-track tapes 

Bit 5=1 Nine-track tapes 



1052 
2671 
2311 



Printer-Keyboard 



No special 
No special 
No special 



features 
features 
features 



Paper Tape Reader 



Disk Storage Drive 



• I/O Request and Continue ; CONTPR 
returns control to SIM20 as soon as 
possible after having accepted the 
request. I/O interruptions related to 
such a request interrupt SIM20 and 
transfer control to CONTPR. CONTPR 
preserves all information related to 
the I/O interruption and, if this 
information indicates that all the I/O 
activity related to the request has 
terminated, returns control to SIM20 at 
a predetermined location. Otherwise, 
control is returned to SIM20 at the 
point of interruption. 



• I/O Request and Interrupt at Channel 
End : This request is similar to the I/O 
request and continue, except that, in 
the absence of unusual conditions, the 
channel- end condition also causes 
CONTPR to return control to SIM20 at a 
predetermined location. 



SVC Calling Sequence Parameters 

The SVC calling sequences for I/O 
requests contain the following parameters: 



• DEV360 gives the System/360 address of 
the device for which the re- 
quest is intended. 



• CAWADD gives the address of the first 

CCW to be executed. (There is 
no restriction on the CCWs that 
can be presented. In particu- 
lar, a string of CCWs connected 
by either data chaining or com- 
mand chaining is permitted. ) 

• STATUS is treated by CONTPR as two 

hexadecimal digits, STRTBT and 
ERRTYP. On receipt of the I/O 
request, both STRTBT and ERRTYP 
are set to zero. 

STRTBT is set to one only when the 
physical I/O operation has been 
initiated at the device. When 
control is returned to SIM20 at 
address ACCRET (request ac- 
cepted) , STRTBT indicates 
whether or not the physical I/O 
operation has been initiated. 
Also, at initial selection, if 
an error condition precludes 
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the initiation of the opera- 
tion, STRTBT is set to one. 

ERRTYP indicates whether or not an 
exceptional condition has oc- 
curred and, if so, the type . of 
condition. 



Control is returned to SIM20 under any 
of the following conditions. 

• Physical I/O operation started: 

STRTBT=1 

Return to address ACCRET 



SNSADD denotes the address of the 
first of three bytes used to 
accumulate the first three 
bytes of sense information dur- 
ing a sense operation performed 
as a result of a unit-check 
condition detected during the 
execution of an I/O request. 
On receipt of an I/O request, 
these bytes are set to zero. 

SVCCSW denotes the address of a 
double-word used to accumulate 
channel status information. On 
receipt of an I/O request, the 
contents of this double-word 
are set to zero. If channel 
and device status information 
is generated on more than one 
occasion during the execution 
of a chain of I/O commands, 
CONTPR accumulates the logical 
"OR" of this status information 
in the appropriate bytes of 
SVCCSW. 

SVCPSW denotes the address of a 
double-word in which is placed 
the I/O old PSW generated by 
the last I/O interruption 
related to the request. (This 
parameter is not present in the 
I/O request and wait calling 
sequence. ) 



I/O Request and Continue (SVC 2) 

The SVC calling sequence used to submit 
an I/O request and continue has the follow- 
ing form: 



I 

DEV360 
CAWADD 
STATUS 
SNSADD 
SVCCSW 
SVCPSW 



ACCRET 



CNOP 4 , 8 

SVC 2 

DC X'Oddd' 

DC A(CCWADD) 

DS C 

DS 3C 

DS D 

DS D 

DC A(NRMRET) 

DC A(EXCRET) 

Any instruction 

(Address 1+36) 



If the associated channel, subchannel, 
control unit, or device is busy, precluding 
initiation of the I/O request, CONTPR 
places this request in a queue until all 
parts of the device path are free. 



• Device path (channel, subchannel, con- 
trol unit, or device) busy: 

Add I/O request to request queue 
STRTBT=0 

Return to address ACCRET 

• Physical I/O operation started and ter- 
minated with no exceptional conditions: 

STRTBT=1 

Place OSVPSW at SVCPSW 

Address ACCRET to address part of 

SVCPSW 

Return to address NRMRET with all 
I/O and external interruptions 
disabled 

• Exceptional condition has prevented the 
starting of the I/O operation or the 
I/O operation has started and terminat- 
ed with an exceptional condition: 

STRTBT=1 

Place OSVPSW at SVCPSW 

Address ACCRET to address part of 

SVCPSW 

Return to address EXCRET with all 
I/O and external interruptions 
disabled 

An I/O interruption related to this 
request interrupts the Simulator and gives 
control to CONTPR. If examination of the 
interruption indicates that not all the 
activity related to the request has termi- 
nated, control is returned to the point of 
interruption. Otherwise, control is re- 
turned to one of the addresses NRMRET or 
EXCRET, according to the conditions de- 
scribed under "Exceptional Conditions." 
The I/O old PSW is placed in the double- 
word with address SVCPSW, and all I/O and 
external interruptions are disabled. 

An I/O request and continue calling 
sequence for a device in the busy or 
chained state is not allowed when SIM20 is 
in the disabled state. 

This SVC calling sequence is not used by 
EDITOR and UPDT20. 



I/O Request and Interrupt at Channel End 
(SVC 1) 

The SVC calling sequence used to submit 
an I/O request and interrupt at channel end 
has the following form: 
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I 

DEV360 
CAW ADD 
STATUS 
SNSADD 
SVCCSW 
SVCPSW 



ACCRET 



CNOP 4 , 8 

SVC 1 

DC X* Oddd' 

DC A(CCWADD) 

DS C 

DS 3C 

DS D 

DS D 

DC A(NRMRET) 

DC A(EXCRET) 

Any instruction 

(address 1+36) 



This calling sequence performs the same 
functions as the I/O request and continue, 
except for the following additional 
facility offered by the I/O request and 
interrupt at channel end. 

When a channel-end condition occurs 
without the device- end condition, a test is 
made for the presence of a unit- exception 
or unit- check condition. 

If neither of these conditions is pre- 
sent, the I/O old PSW is placed in the 
double-word with address SVCPSW, and con- 
trol is returned to SIM20 at location 
NRMRET with all I/O and external interrup- 
tions disabled. Otherwise (channel end 
accompanied by unit check or unit 
exception) , control is returned to SIM20 at 
the point of interruption. Thus, on de- 
vices for which channel end and device end 
occur separately, there can be two returns 
to NRMRET. 

This SVC calling sequence is not used by 
EDITOR and UPDT20. 



and wait to terminate, 
are processed normally. 



Such interruptions 



An I/O request and wait calling sequence 
is not allowed when EDITOR is in the 
disabled state. 

This SVC calling sequence is not used by 
SIM20 and DSKINT. 



Exceptional Conditions 

Control is returned to SIM20 at address 
NRMRET with ERRTYP=0 (no exceptional condi- 
tions encountered) or at address EXCRET for 
the following conditions: 



No unit control block exists 
device (ERRTYP=2). 



for this 



The device or its associated control 
unit, subchannel, or channel is not 
operational (ERRTYP=1). 



A program- check or 
condition has been 
channel (ERRTYP=3). 



pr otecti on- che ck 
detected by the 



A unit- check 
(ERRTYP=0) . 



condition has occurred 



A sense operation is performed on 
the device, and a maximum of three 
bytes of sense information are 
stored, starting at address SNSADD. 

A unit- exception or chaining-check con- 
dition has occurred (ERRTYP=0) . 



I/O Request and Wait (SVC 11) 

The SVC calling sequence used to submit 
an I/O request and wait has the following 
form: 



Note: The first two of these exceptional 
conditions are mutually exclusive, but the 
last three may occur concurrently. In this 
case, ERRTYP is set to the value corre- 
sponding to the first exceptional condition 
detected. 





CNOP 


4,8 


I 


SVC 


11 


DEV360 


DC 


X'Oddd* 


CAW ADD 


DC 


A(CCWADD) 


STATUS 


DS 


C 


SNSADD 


DS 


3C 


SVCCSW 


DS 


D 


EXCRET 


Any 


four- byte instruction 




(address 1+20) 


NRMRET 


Any 


instruction (address : 



STRTBT is significant only in the I/O 
request and continue/ interrupt at channel- 
end calling sequences. In the I/O request 
and wait, it always contains the value one 
(physical I/O operation initiated at the 
device) when control is returned to EDITOR. 

I/O and external interruptions related 
to other I/O requests are allowed to occur 
while CONTPR is waiting for the I/O request 



Channel Status Information 

Information from the CSWs which can be 
generated as a consequence of the execution 
of an I/O request is accumulated in the 
double-word SVCCSW. On receipt of an I/O 
request, CONTPR sets the contents of SVCCSW 
to zero. 

The execution of a chain of I/O commands 
produces, at most, one non-zero value each 
for the command address and count parts of 
a CSW. (CONTPR ignores any SVC in which 
the program-controlled interruption is the 
only status bit present. ) The values of 
these quantities are set into the appropri- 
ate bytes of SVCCSW. 

If non-zero values of the two status 
bytes are produced during the execution of 
a chain of I/O commands, CONTPR accumulates 
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the logical "OR" of this status information 
in the appropriate bytes of SVCCSW. 

If, when a chain of I/O commands has 
terminated, a unit-check status bit is 
present in SVCCSW, CONTPR performs a sense 
operation and places a maximum of three 
bytes of sense information, starting at 
address SNSADD. 

When control is returned to SIM20 with 
ERRTYP=1 or 2, SVCCSW always contains zero, 
indicating that no I/O operation has start- 
ed for the I/O request. 

When control is returned with ERRTYP=3, 
the I/O operation has terminated, and 
SVCCSW (and, in the case of unit check, the 
bytes at SNSADD) describes the state of 
this termination. 



I/O PROCESSING WITHIN CONTPR 

The following paragraphs contain an out- 
line of the techniques used by CONTPR in 
scheduling input/output operations. These 
techniques are explained with particular 
reference to the I/O request and continue 
(SVC 2) calling sequence. 

Control Blocks 

CONTPR associates a block of 28 bytes of 
System/360 main storage, called a unit 
control block, with each System/360 device. 
Each unit control block contains informa- 
tion giving the address, characteristics, 
and status of a device. 

With each System/360 channel, CONTPR 
associates a block of eight bytes of 
System/360 main storage. This block is 
called a channel control block and is used 
to control the chaining of I/O requests for 
the associated channel (see "Chaining I/O 
Requests") . 

Three general registers (I, J, and K) 
are assigned to contain the addresses of 
the first byte of an SVC calling sequence, 
of a unit control block, and of a channel 
control block, respectively. Hence, using 
I, J, or K, any element in an SVC calling 
sequence, in a unit control block, or in a 
channel control block may be expressed as a 
displacement augmented by the contents of 
I, J, or K. 

Processing an SVC 2 Calling Sequence 

Charts FC and FD show how an SVC 2 
calling sequence is processed by CONTPR. 
This processing is divided into two parts, 
as follows : 

Part 1: This part is entered once to ini- 



tiate the physical I/O operation, 
if possible. 

Part 2: This part may be entered more than 
once. It is entered once for each 
I/O interruption associated with 
the physical activity initiated by 
part 1. 

GETUCB Routine 

The GETUCB routine uses the System/360 
device address to generate the index pair 
(J,K). It uses the device table DEVTAB. 
There is one DEVTAB table for each 
System/360 channel. Each DEVTAB table con- 
tains a set of consecutive full-word 
entries corresponding to the devices 
attached to a channel. 

Bits S through 7 of each word contain 
the System/360 address of the device, 
excluding the channel part. 

Bits 8 through 31 of each word contain 
the address of the associated unit control 
block. 

STRTIO Routine 

The STRTIO routine tries to initiate an 
I/O operation and, depending upon the con- 
ditions encountered, has one of the follow- 
ing exits: 

TERM The operation has been started 

and terminated immediately with- 
out unit check, unit exception, 
or other error conditions. 

DEVBSY The device is busy with some 
previous I/O request. 

PATHB The associated channel, subchan- 

nel, or control unit is busy, or 
the operation must be delayed 
because some outstanding sense 
requests have not yet terminated. 

EXCEPT The operation cannot be started 
because of a unit-check or unit- 
exception condition on the 
device. 

The operation has been started 
and terminated with a unit-check 
or unit-exception condition. 

The device is not operational. 

A program-check condition has 
occurred. 

CHEND The operation has produced an 

immediate channel-end condition. 

START The operation has started without 

any immediate status conditions. 
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For the exit EXCEPT, if a unit-check 
condition has occurred, the STRTIO routine 
calls the SENSE subroutine. 

SENSE Subroutine 



Any I/O interruption, except an atten- 
tion interruption, received for a device 
which is in the available or chained state 
is ignored. 



The SENSE subroutine carries out a sense 
operation and places the first three sense 
bytes in the SVC calling sequence, and the 
last three sense bytes in the unit control 
block. 

IOINT Routine 

The IOINT routine is entered following 
an I/O interruption, and has one of the 
following exits : 

TERM The operation has terminated 

without unit check, unit excep- 
tion, or other error conditions. 

EXCEPT The operation has terminated, and 
a unit- exception, chaining- check, 
or protection-check condition has 
occurred. 

SENSE The operation has terminated, and 
a unit- check condition has been 
detected. 

CHEND A channel-end condition has been 

detected. 



Available State 



I/O REQUEST AND WAIT ; If the device for 
which the request is received is in the 
available state, CONTPR tries to start the 
corresponding I/O operation. If the status 
of the channel, subchannel, control unit, 
or device precludes initiation of the oper- 
ation, CONTPR cycles 1 - on the SVC calling 
sequence until the request is accepted. 
Otherwise, the operation is started, the 
busy state is set, and CONTPR cycles on the 
SVC calling sequence until all related I/O 
interruptions have been received and pro- 
cessed. 

I/O REQUEST AND CONTINUE/INTERRUPT AT CHAN- 
NEL END ; If the device for which the 
request is received is in the available 
state, CONTPR tries to start the corre- 
sponding I/O operation. It sets either the 
busy state (operation started) or the 
chained state (operation waiting) and 
returns control to SIM20 at address ACCRET 
(request accepted) . 



OTHER None of the above. 

In the case of the exit SENSE, a request 
to carry out a sense operation for this 
device is added to the chain of waiting I/O 
requests for the associated channel. 
Furthermore, CONTPR has a parameter, 
labeled SNSCNT, whose value is equal to the 
number of outstanding sense requests on all 
System/360 channels. If any I/O request is 
attempted when SNSCNT is non-zero, the 
STRTIO routine returns to exit PATHB. This 
is done to avoid destroying sense informa- 
tion by a subsequent I/O request. 

Chaining I/O Requests 

The state of a given device at any 
moment is determined by CONTPR from infor- 
mation in its associated unit control 
block. CONTPR treats each device as being 
in one of the following three states: 



Busy or Chained State 

Any I/O request received for a device in 
the busy or chained state causes CONTPR to 
cycle on the new SVC calling sequence. 



Adding a Request to a Chain 

The channel control block with, for 
example, address K for a particular 
System/360 channel contains two full-word 
quantities labeled IOQBEG (K) and IOQEND (K) , 
used in chaining I/O requests for this 
channel. Furthermore, each unit control 
block with, for example, address J attached 
to this channel contains a full-word quan- 
tity labeled DEVCHN(J). 

Initially, when no requests are chained: 

• IOQBEG (K) contains zero. 



CONTPR has started activity 
for some I/O request, and 
this activity has not yet 
terminated. 

Not busy; an SVC 1 or SVC 2 
calling sequence for the 
device has been received, 
but cannot yet be executed. 



• Available Not busy and not chained. 



Busy 



• Chained 



IOQEND (K) contains 
IOQBEG (K) . 



the address 



of 



*To "cycle" means that CONTPR places the 
address of the SVC instruction into the 
address part of the supervisor-call old 
PSW and then loads this PSW. Thus, CONTPR 
returns to the SVC instruction, which is 
repeated until the operation can be ini- 
tiated. 
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• DEVCHN(J) contains zero for all the 
unit control blocks on the channel. 

To add a request to a chain, the follow- 
ing steps are carried out: 



Extract the 
IOQEND(K) . 



address contained in 



2. Place at this address the value of J 
associated with the I/O request. 

3. Place DEVCHN(J) at the address 
IOQEND(K) . 

Then, if two values of J (for example, 
J x and J 2 ) are added to the chain: 



• IOQBEG(K) contains J ± . 

• DEVCHN( J^) contains J 2 . 

• DEVCHN(J 2 ) contains 0. 

• IOQEND(K) contains DEVCHN(J 2 ). 

all 



other 



• DEVCHN(J) contains for 
devices on this channel. 

Types of Requests Chained 



Two types of request may be added to a 
channel chain : 

1. SVC 1, SVC 2, SVC 13, and SVC 14 
requests for which the exit PATHB is 
taken when the STRTIO routine is 
called 

2. Sense operation requests for which the 
exit SENSE is taken when the IOINT 
routine is called 

(A parameter in the unit control block 
enables CONTPR to distinguish between these 
two types of request.) 

UNSTAK Routine 

The UNSTAK routine (see Chart FE) 
attempts to initiate as many I/O operations 
on a designated channel as possible. The 
routine is entered with one input parame- 
ter, the channel index K. 

Any unit control block for which an I/O 
operation is started (or is inhibited owing 
to exceptional conditions) is removed from 
the chain of requests for this channel. 



SETTING UP THE SEREP INTERFACE (SVC 7) 

If certain unrecoverable conditions are 
encountered during the execution of an I/O 
request, there is no return from CONTPR to 
EDITOR. Instead, the standard SEREP inter- 
face is set up. 



During the execution of an I/O request, 
one of the following conditions may occur: 

• One or more of the channel status 
indications (channel control check, 
interface control check, channel data 
check) is detected. 

• A channel or device status indication 
which should not occur is detected. 

• A sense operation cannot be performed 
on a device. (Such a sense operation 
is attempted each time the execution of 
an I/O request gives rise to a unit- 
check condition . ) 



In these situations, 
main storage the elements 
standard SEREP interface, 
in which I/O and external 
disabled, in which the 
one, and for which all 
code bits are ones. 



CONTPR sets up in 
necessary for the 
It loads a PSW 
interruptions are 
wait state bit is 
the interruption 



In all other cases, control is returned 
to EDITOR. 

EDITOR may find it necessary, as a 
result of the conditions under which an I/O 
request has terminated, to set up the SEREP 
interface. (For example, the condition 
ERRTYP=1 may be interpreted as a SEREP 
condition. ) 

The following calling sequence should be 
used in EDITOR to request that CONTPR set 
up the standard SEREP interface: 



I 

TYPE 



CNOP 
SVC 
DC 
DC 



2,4 
7 

X'tf 

AL3 (IOREQ) 



tt 



denotes the type of interface which is 
required. Thus: 

tt=0F indicates a channel failure. 
tt=lF indicates a device failure. 
tt=3F indicates a device-not-opera- 
txonal condition. 



IOREQ 



denotes the address of the SVC 
instruction in the calling sequence of 
the I/O request which gave rise to 
this SEREP condition. 



CONSOLE COMMUNICATION 

Two types of console communication are 
handled by CONTPR. The first type allows a 
message to be sent from EDITOR to the 1052 
Printer-Keyboard, and the second allows 
transmission of a command from the 1052 to 
EDITOR in response to an attention inter- 
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ruption from the operator. There are no 
facilities for processing queues of mes- 
sages or commands. SIM20 and DSKINT do not 
use CONTPR for console communication. 



Write Message (SVC 4) 

A request to write a message can be 
submitted by EDITOR to CONTPR using an SVC 
calling sequence of the following form: 



• The message was written 
(BUFF=X'07') . 



without error 



I 
N 

1+6 

The bytes 
locations 



CNOP 
SVC 
DC 
DC 



2,4 

4 

X'nn' 

AL3 (BUFF) 



Any instruction 
to be printed are taken from 



BUFF+1, BUFF+2, . . .BUFF+X'nn* 

CONTPR sends the contents of these bytes 
to the 1052 Printer-Keyboard, using a Write 
Inhibit Carrier Return command. Conse- 
quently, if a new line is required at the 
end of the message, the "new line" charac- 
ter should be set up in location 
BUFF+X'nn' . 

If, when a write message calling 
sequence is submitted, CONTPR is busy with 
a read or write request for the printer- 
keyboard, it cycles on the calling sequence 
until the previous request has terminated. 
When it accepts the calling sequence, it 
sets the contents of the byte at address 
BUFF to X'00', initiates the writing of the 
message, and returns control to EDITOR at 
address 1+6. 

When the request has terminated, CONTPR 
sets the byte at address BUFF to some 
non-zero value. Thus: 

• A programming error has been detected. 
This probably indicates that part of 
CONTPR has been overwritten (BUFF= 
X'03') . 

• A device error has been detected during 
the printing of the message. CONTPR 
repeats the message; if a second error 
occurs, a control alarm is issued 
(BUFF=X* 01' ) . 

If no second error occurs, BUFF=X'07'. 

• A device error has prevented the 
printing of the message. CONTPR tries 
to repeat the operation. If the fail- 
ure occurs again, a control alarm is 
issued, and the SEREP interface is set 
up. 



When EDITOR is in the disabled state, a 
write message request cannot be submitted 
unless the disabled state was caused by an 
interruption resulting from an operator 
command at the 1052 Printer- Keyboard. 

This SVC calling sequence is not used by 
SIM20 and DSKINT. 



Command Input (SVC 5) 

When the attention key on the 1052 
Printer-Keyboard is pressed, EDITOR is 
interrupted and CONTPR is entered. In 
response to this interruption, CONTPR sets 
up and executes a read command. Informa- 
tion is read from the 1052 into a command 
buffer. When the reading operation has 
terminated, control is returned to EDITOR 
at a predetermined address. 

Before information can be transmitted 
from the 1052 to the Simulator, an SVC 
calling sequence of the following form must 
be submitted: 



I 
N 

COMLEN 

COMPSW 
1+18 



CNOP 

SVC 

DC 

DC 

DC 

DC 

DS 



6,8 

5 

X'nn' 

AL3 (BUFF) 
X'00' 

AL3 (COMRET) 
D 



Any instruction 



If the failure 
BUFF=X'07* . 



does not occur again, 



This calling sequence need be presented 
to CONTPR only once, and the parameters 
which it contains are used, as described 
below, in conjunction with all the commands 
from the operator. (Any attention inter- 
ruptions which occur before this calling 
sequence is submitted are ignored.) 

The byte at address COMLEN contains the 
number of characters read. 

X'nn' denotes the maximum number of 

characters that can be read. Hence, the 

number of characters, COMLEN, can never 
exceed X'nn' . 

The characters of any command are placed 
in locations 

BUFF+1, BUFF+2, . . . BUFF+COMLEN 

The following termination conditions may 
be associated with the reading of a com- 
mand: 

• A device error has been detected during 
the reading of the command. CONTPR 
issues an error message for the opera- 
tor and returns control to the point of 
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interruption. Thus, the command is 
ignored. 

• A control alarm is issued and the SEREP 
interface is set up. This may be the 
result of one of the following condi- 
tions: 

1. A device error has prevented the 
reading of the command. CONTPR 
has retried the operation and the 
failure has occurred again. 

2. The error message to the operator, 
in the case of a device error 
during the execution of a read 
command, cannot be written. 

• A programming error has occurred. This 
probably indicates that part of CONTPR 
has been overwritten (BUFF=X' 03 1 ) . 

• The command has been read without error 
(BUFF=X* 07 » ) . 

For the last two of these termination 
conditions, control is returned to EDITOR 
at location COMRET with all I/O and exter- 
nal interruptions disabled. The PSW of 
EDITOR at the point of interruption is 
placed in location COMPSW. 

To avoid the possibility of overwriting 
the information in the command buffer by a 
subsequent command from the operator, the 
sequence starting at location COMRET should 
have completely processed this information 
before returning to the point of interrup- 
tion. 

The cancel condition at the 1052 
Printer-Keyboard is treated normally; that 
is, a new request to read from the 1052 is 
issued. 

This SVC calling sequence is not used by 
SIM20 and DSKINT. 



Disable Console (SVC 15) 

The SVC calling sequence 

I SVC 15 

causes attention interruptions (resulting 
from an operator command on the 1052 
Printer-Keyboard) to be ignored. 

This SVC calling sequence is not used by 
SIM20 and DSKINT. 



Enable Console (SVC 16) 

The SVC calling sequence 
I SVC 16 



causes such attention interruptions to be 
accepted if an SVC 5 calling sequence (set 
command parameters) has been previously 
submitted. 



This SVC calling sequence is not used by 
SIM20 and DSKINT. 



SIM20 INTERRUPTION AND RETURN (SVC 3) 

When an interruption occurs, control is 
given to CONTPR, which may return control 
either to the point of interruption or to a 
predetermined location. In the latter 
case, the old PSW at the point of interrup- 
tion is stored in a double-word at a 
predetermined address. In addition, all 
I/O and external interruptions are dis- 
abled. 



Control may be returned to the point of 
interruption by using an SVC calling 
sequence of the form: 



CNOP 2 , 4 

I SVC 3 

DC A(RETPSW) 



where RETPSW denotes the predetermined 
address at which CONTPR has stored the old 
PSW. 

The current PSW is replaced by the 
contents of the double-word with address 
RETPSW, thus returning control to the point 
of interruption. 



REWIND AND REWIND-AND-UNLOAD CALLING 
SEQUENCES (SVC 13 AND 14) 

When an I/O request and continue calling 
sequence is used to rewind or to rewind and 
unload a 2400-Series Magnetic Tape Unit, 
the operation is normally terminated (and 
EDITOR interrupted) only when the device- 
end signal is received from the tape unit. 

The two SVC calling sequences given 
below enable CONTPR to terminate the 
operation when the channel-end signal is 
received. In this case, I/O interruptions 
for the tape unit which occur after the 
channel-end signal has been received are 
ignored. 

The following SVC calling sequences are 
used for the rewind and rewind-and-unload 
functions : 
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or 





CNOP 


4,8 


I 


SVC 


13 (Rewind) 


I 


SVC 


14 (Rewind-and- Unload) 


DEV360 


DC 


X* Oddd* 


CAW ADD 


DC 


A(CCWADD) 


STATUS 


DS 


C 


SNSADD 


DS 


3C 


SVCCSW 


DS 


D 


SVCPSW 


DS 


D 




DC 


A(NRMRET) 




DC 


A(EXCRET) 


ACCRET 


Any 


instruction 




(address 1+36) 



When a channel- end condition occurs 
without device end, the following tests are 
made. 

Rewind; Has a unit- exception or unit- 
check condition occurred? 

Rewind- and-Unload : Has a unit-exception 
condition occurred? 

If not, control is returned to EDITOR at 
location NRMRET and the device- end 
condition is ignored. Otherwise, the ter- 
mination of this operation is identical to 
that of the I/O request and continue opera- 
tion. 

CONTPR makes no check for the validity 
of the command code in the CCW provided by 
EDITOR. Thus, in EDITOR, a command code 
corresponding to the operation to be per- 
formed must be placed in the CCW. If it is 
not, CONTPR treats the calling sequence as 
an I/O request and continue calling 
sequence, but terminates the operation as a 
rewind or rewind- and-unload. 

These two SVC calling sequences are not 
used by SIM20 and DSKINT. 



SET WAIT STATE (SVC 19) 

The SVC calling sequence 

I SVC 19 

sets the wait state bit "on" in the current 
PSW. ALL I/O and external interruptions 
are enabled. 

When an I/O or external interruption 
occurs, CONTPR is entered. The wait state 
bit is set "off" in the old PSW at the 
point of interruption, and control is 
returned either to the point of interrup- 
tion by loading the old PSW, or to a 
predetermined location. The old PSW at the 
point of interruption is also stored at a 
predetermined location. 

This SVC calling sequence is not used by 
SIM20 and DSKINT. 



DUMP SYSTEM/360 MAIN STORAGE (SVC 12) 

This SVC calling sequence is not used by 
the 1620 Simulator. 



INTERFACE WITH IOPACK 

The two following SVC calling sequences 
are used to request that an I/O operation 
be performed on an EDITOR support device. 
On receiving the calling sequences, CONTPR 
transfers control to IOPACK. 

These two SVC calling sequences are not 
used by SIM20 and DSKINT. 

Assign a System/360 Device to a Simulator 
Support Function (SVC 17) 

Before a request for an I/O operation by 
an EDITOR support device can be submitted 
to IOPACK, an SVC 17 calling sequence must 
be submitted to CONTPR. 

Execute an I/O Operation on a Simulator 
Support Device (SVC 18) 

To execute an I/O operation on an EDITOR 
support device, an SVC 18 calling sequence 
must be submitted to CONTPR. 



I/O SUPPORT PACKAGE (IOPACK) 

IOPACK (see Chart FF) is a subprogram 
consisting of a set of routines which 
perform logical I/O operations on 
System/360 I/O devices used for EDITOR 
support functions. It also performs logi- 
cal I/O operations for UPDT20; but, to 
simplify the presentation, this description 
refers only to EDITOR. 

The I/O operations which IOPACK is 
designed to perform and the associated 
System/360 devices are given in Table 14. 

All these routines are designed for 
non-overlapped operation. Thus, program 
execution is suspended until the I/O opera- 
tion has terminated. 

IOPACK examines the error conditions 
which can occur when operating the devices 
given in Table 14 , and takes the action 
prescribed by System/360 standards. Opera- 
tor message facilities are provided via the 
1052 Printer-Keyboard. 



SYSTEM/360 DEVICE ASSIGNMENT (SVC 17) 

When an SVC 17 calling sequence is 
submitted to CONTPR, control is transferred 
to IOPACK. 
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Table 14. Logical I/O Operations 



r T" 

I OPERATION i 



SYSTEM/360 DEVICE 



Read a card 



1442 Card Read Punch, Model Nl 
2501 Card Reader, Model Bl or B2 
2520 Card Read Punch, Model Bl 
2540 Card Read Punch 



-H 



Punch a card 
(optional) 



1442 Card Read Punch, Model Nl 
2520 Card Read Punch, Model Bl 
2540 Card Read Punch 



Write a message 



1052 Printer-Keyboard 



-H 



Read a command 



1052 Printer- Keyboard 



Print a line 



1403 Printer 
1443 Printer 



Print a line and skip 
to the first line on 
the next page 



1403 Printer 
1443 Printer 



Read a tape record 



2400-Series Magnetic Tape Unit 
Model 1, 2, or 3 



Write a tape record 



2400-Series Magnetic Tape Unit 
Model 1, 2, or 3 



Write a tape mark 



2400-Series Magnetic Tape Unit 
Model 1, 2, or 3 



The SVC 17 calling sequence has the 
following form: 



I 

SYMBOL 
DEV360 
TYPE 
IOTYPE 

1+20 



CNOP 

SVC 

DS 

DC 

DC 

DS 

DC 



0,4 

17 

8C 

X'Oddd* 
C^ttt' 

C 

AL3( ERROR) 



Any instruction 



This calling sequence assigns the 
System/360 device address given by DEV360 
to the symbolic name SYMBOL. 

SYMBOL is a symbolic name assigned by 
EDITOR to a System/360 device. This name 
may contain from one to eight characters, 
being any combination of alphabetic and 
numeric characters. The first character 
must be alphabetic, the symbolic name is 
left-adjusted, and all remaining characters 
in the eight-byte field must be blank. 



IOTYPE is one character, I or O, which 
specifies the type of operation (input or 
output) to be performed on the device named 
SYMBOL. "ddd" denotes the System/360 
address and "tttt" the type of this device. 



The types of device and the operations 
accepted on them are as follows: 



2540,2520,1442 
2501 

1403,1443 

2400 

1052 



I (O optional) 

I 

o 

I and O 
I and O 



With each SYMBOL, DEV36 group is asso- 
ciated a block of control information in a 
table called SYMTAB. 

IOPACK verifies the following condi- 
tions : 

• SYMTAB is not full. 
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If the table is full, IOTYPE is set to 
X'01' . 

• A routine exists for the operation to 
be performed and for the device to be 
us ed. 

If not, IOTYPE is set to X'02'. 

• A unit control block in CONTPR exists 
for this device. 

If not, IOTYPE is set to X'03'. 

In the above cases, when IOTYPE is set 
to X'02' or X'03', control is returned to 
EDITOR at location ERROR. Otherwise, the 
SYMBOL, DEV360 group is placed in SYMTAB and 
control is returned to EDITOR at location 
1+20. 

SYMTAB can contain a maximum of 10 
SYMBOL, DEV360 groups. Once an entry is 
placed in the table, it cannot be removed. 
Therefore, the SVC 17 calling sequence 
either adds a new SYMBOL, DEV360 group to 
the table (if the table is not full), or 
assigns a different System/360 device to a 
symbol already in the table. 

SYMTAB is created when IOPACK is ini- 
tialized, before EDITOR is loaded. The 
contents of the table remain unchanged when 
control is transferred from RELLDR to EDI- 
TOR. 

Control Card Entry ; The functions of the 
SVC 17 calling sequence may be performed by 
entering a control card at the time of 
program initialization. This control card 
has the following format: 

/ DEVSUP SYMBOL=X ' ddd' , tttt , IOTYPE 

where SYMBOL, "tttt", "ddd", and IOTYPE 
denote the same quantities as in the SVC 17 
calling sequence. The blanks before and 
after DEVSUP must be respected. 



of the I/O buffer for the device being 
used. 

The data is fetched from or placed in 
locations 

BUFF+l,BUFF+2, . . .BUFF+X'nn' 

For an output operation on the 1403 or 
1443 Printer, the EBCDIC character in loca- 
tion BUFF+1 specifies the type of print 
command, as follows: 

The character "1" Write and skip to 

channel 1 after print- 
ing. 

Any other character Write and space one 

line after printing. 

Thus, the data is fetched from locations 

BUFF+2,BUFF+3, . . . BUFF+X'nn' 

For an output operation on a 2400-Series 
Magnetic Tape Unit, it may be necessary to 
write a tape mark (particularly after a 
unit exception has occurred, denoting the 
end of tape) . To write a tape mark, COUNT 
must contain one (nn=l) and BUFF+1 must 
contain a 7-8 punch (hexadecimal 7F) . 

The I/O operation is performed using an 
SVC 11 calling sequence (I/O request and 
wait) . CONTPR cycles on the SVC 11 calling 
sequence until the request has terminated. 
The request may terminate in any of the 
following ways: 

• An unrecoverable error has occurred. 
Control is returned either from CONTPR 
to IOPACK, or from IOPACK to EDITOR. 
In the first case, the standard SEREP 
interface is set up. In the second 
case, a message is issued requesting 
that a System/360 dump program be load- 
ed (a part of the system has probably 
been over-written) , or that the stand- 
ard SEREP program be loaded (a machine 
malfunction has been detected) . 



EXECUTE A LOGICAL I/O OPERATION (SVC 18) 

The SVC calling sequence used to request 
a logical I/O operation on an EDITOR sup- 
port device has the following form: 



The device SYMBOL is unknown to IOPACK. 
It has not been defined by a control 
card, nor by an SVC 17 calling 
sequence. The byte at address BUFF is 
set to the value X"01*. 



I 

SYMBOL 
COUNT 
BUFFER 
1+16 



CNOP 

SVC 

DS 

DC 

DC 



0,4 

18 
8C 

FL2*nn* 
A (BUFF) 



Any instruction 



SYMBOL denotes the same quantity as in 
the SVC 17 calling sequence. COUNT con- 
tains the number of bytes of data to be 
processed, and BUFFER contains the address 



• A device malfunction has been detected 
during the execution of the I/O 
request, and a message has been issued 
to inform the operator of the malfunc- 
tion. IOPACK has received a command to 
terminate the I/O operation. The byte 
at address BUFF is set to the value 
X'02' . 

• A unit- exception condition has occurred 
during a read or write operation on a 
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magnetic tape unit. A message is 
issued and control is returned to EDI- 
TOR, with the byte at address BUFF set 
to the value X' 03' . 

• None of the above conditions has 
occurred; that is, the I/O operation 
has terminated with no exceptional con- 
ditions. The byte at address BUFF is 
set to the value X'QT. 

In the last of these cases, IOPACK 
returns control to EDITOR at location 1+16. 



INITIALIZATION PROGRAM (IN IT) 

This subprogram (see Chart FG) initial- 
izes CONTPR, IOPACK, and RELLDR for an 
EDITOR or UPDT20 run. To simplify the 
presentation, this description refers only 
to EDITOR, but is valid for both programs. 
Initialization is performed in the follow- 
ing manner: 

CONTPR: It initializes the 1052 Printer- 
Keyboard Read/Write routine and creates the 
channel and unit control blocks. 

IOPACK : It creates SYMTAB, which assigns 
System/360 devices to the symbolic names of 
EDITOR support devices . 

RELLDR : It selects the program to be 
loaded, defines the length of the loader 
tables, the output device to be used by the 
Self- Loading Program Generator routine (if 
it is required) , and the names of any 
control sections which must not be loaded. 

Three types of control card are used by 
the program for the above functions; these 
are, respectively, DEV360, DEVSUP, and CALL 
cards. The format and contents of these 
cards are described in the publication IBM 
System/360 Conversion Aids: The 1620 Simu- 
lator for IBM System/360 , Form C28-6529. 
The program translates the mnemonic operand 
terms in the cards by means of a dictionary 
(DICT) which contains, against each oper- 
and, the action to be taken and any data 
required for this action. 



PROGRAM STRUCTURE 

To simplify the presentation, the 
program may be divided into five phases. 

Phase 1 

ABSLOD has loaded CONTPR, IOPACK, INIT, 
and RELLDR, and has prepared the following 
data in the general registers: 

• The address of the last byte of CONTPR 



• The current value of the location 
counter (address of the first byte 
following IOPACK) 

• The address in RELLDR to which control 
must be transferred at the end of INIT 

Control is transferred to INIT, which 
needs to read control information but does 
not know the address of the device on which 
to read it. It cannot issue a message to 
the operator since the address of the 1052 
Printer-Keyboard is also unknown, so it 
sets the system in the wait state. The 
operator then presses the request key on 
the 1052, causing an attention interrup- 
tion. The program now inserts in a CCB and 
a UCB at the end of the program the address 
of the 1052 which is recorded in the I/O 
old PSW, and issues a message to the 
operator requesting the address of the 
control information input device. 

When the operator has typed a command 
indicating the type and address of the 
input device, a UCB (together with a CCB if 
the device is not on the same channel as 
the 1052 Printer-Keyboard) is completed for 
this device. 

Phase 2 

Each control card or card image (on 
tape) is read, listed on the 1052 Printer- 
Keyboard, and analyzed with the aid of the 
dictionary (DICT) ; the result is then 
entered, in condensed form, in a table 
(TABLE). This table is created in front of 
INIT during program execution and overlays 
the first routine (initialization) of this 
program. The table is filled backwards; 
that is, the first element is contiguous to 
INIT, and the table is extended to the 
front as new elements are added. The 
condensed DEV360 card images are sorted in 
order of increasing channel-unit addresses 
and are placed in the first part of the 
table; the condensed DEVSUP card images are 
placed after the last DEV360 card image, in 
the order in which they are read. The 
length of the table is adjusted as each 
card image is entered. 

The last card in the deck is the CALL 
card and it is processed as follows: 

1. The name of the program to be loaded 
by RELLDR is placed in the dictionary 
for later use. 

2. If the selective loading feature is to 
be used, flags are set in the list of 
optional control sections against 
those which will be required. 

3. If the term LIST is present, a flag is 
set on to inform RELLDR that, later, 
it must print loading messages. 
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4. If the term "INIT=nnnnnn" is present, 
the symbolic name "nnnnnn" is saved to 
inform RELLDR on which output device 
the self-loading program must be gen- 
erated. 

5. A card punching routine, which may be 
used by the Self -Loading Program Gen- 
erator routine, is included at the end 
of IOPACK. If the output device 
called by the term " INIT=nnnnnn" is 
not a card punch, this card punching 
routine will not normally be required; 
therefore, the location counter is 
decremented by the length of this 
routine to save storage space. Should 
the card punching routine be required 
in another program (UPDT20 , for 
example) , the term PUNCH must be added 
to the operand field of the CALL card 
to prevent the location counter from 
being decremented. 

Phase 3 

The program uses the data contained in 
the first part of the table (TABLE) to 
build up channel and unit control blocks in 
storage, starting at the address contained 
in the location counter. 

One channel control block is created for 
each available System/360 channel, and one 
unit control block for each available 
device. The format of channel and unit 
control blocks is discussed in the section 
"I/O Simulation." 

As each control block is created, the 
location counter is incremented and, at the 
end of this phase, it points to the first 
byte following the last unit control block 
created. 

Phase 4 

With the data stored in the second part 
of the table (TABLE) , the program creates 
SYMTAB in IOPACK by means of SVC 17 calling 
sequences. This calling sequence is de- 
scribed in the section "I/O Support Pack- 
age." 

If the EDITOR support device which will 
be used to load the program specified in 
the CALL card is not defined at this point, 
the program stops after issuing an error 
message, and cannot continue. 

Phase 5 

The program now prepares to transfer 
control to RELLDR. The name of the program 
to be loaded, which is in the dictionary, 
is used to check that the file about to be 
read is the correct one. The first card or 
card image in the file is read. This first 
card is the PROGNAME card, which contains 
the name of the program and the size of the 
loading tables required to load it. 



It is assumed that in the case of a 
program on cards, the first card read will 
be the correct one; that is, that unwanted 
programs will have been removed. Should 
this not be the case, an error message will 
be printed and the program will stop. 

In the case of a program on tape, if the 
name in the PROG NAME card image is not the 
name required, the file will be skipped, 
and the next PROGNAME card image will be 
read and checked. This action is repeated 
until the correct file is found or until 
the SYSINEND card image is met. In the 
latter case, an error message will be 
printed, and the program will stop. 

INIT prepares a list of parameters for 
RELLDR which contains, in all cases, the 
following items: 

• The size of the loader tables needed to 
load the specified program 

• The current value of the location 
counter 

• A flag to indicate whether or not 
loader messages should be issued 

The list of parameters may also contain 
one or more of the following items, depend- 
ing on which terms were present in the CALL 
card: 

• The symbolic name and the address of 
the output support device 

• The name(s) of the control section (s) 
to be ignored in the program about to 
be loaded 

If the term "INIT=nnnnnn" was present in 
the CALL card, and if the 1052 Printer- 
Keyboard used before the self-loading 
program is created is not the same as the 
one to be used afterwards, then the param- 
eters prepared for RELLDR must include the 
address of the 1052 to be used after the 
self-loading program has been created, and 
the address of its unit control block. 

Once the list of parameters is complete, 
INIT transfers control to RELLDR at the 
address which was specified by ABSLOD. The 
system then operates in the problem state, 
disabled for all interruptions except a 
machine check or a program check. 



CARD SEQUENCE 

DEV360 and DEVSUP cards may be mixed and 
in any order, but the last card must be the 
CALL card since, in addition to the func- 
tions indicated above, it marks the end of 
control information input. Should the CALL 
card not be the last, the DEV360 and DEVSUP 
cards placed after it will be ignored and 
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will cause an error at some time during 
program execution. 

If two DEV360 cards define different 
devices at the same address, only the 
latter definition is retained. Similarly, 
if two DEVSUP cards assign the same symbol- 
ic name to two System/360 devices, only the 
latter assignment is retained. 



LINKAGE WITH CONTPR AND IOPACK 

INIT, after it has initialized CONTPR 
during phase 1, uses both that program and 
IOPACK to read the control information and 
to issue messages. The linkage between 
these programs is discussed in the sections 
"Control Program" and "I/O Support Pack- 
age." 



MESSAGES 

Messages are printed by INIT on the 1052 
Printer- Keyboard to inform the operator of 
any errors detected while the control 
information is read or during the initiali- 
zation itself (phases 3, 4, and 5). These 
messages are listed and explained in the 
publication IBM System/360 Conversion Aids: 
The 1620 Simulator for IBM System/360 , Form 
C28-6529. 



RELOCATING LOADER (RELLDR) 

RELLDR (see Chart FH) is used to load 
EDITOR or UPDT20, whichever is specified in 
the CALL control card. 



The distinguishing feature of this load- 
er, as opposed to ABSLOD, is its ability to 
load control sections into storage at 
addresses other than those assigned by the 
assembler; that is, to relocate them, and 
to complete linkage among the sections by 
means of special tables. 

RELLDR uses the location counter 
(LOCCTR) to determine where control sec- 
tions will be loaded. Initially, LOCCTR 
indicates the first byte that follows the 
last unit control block created by INIT. 
Thereafter, it is incremented by the number 
of bytes indicated in an ESD type term 
(see "ESD Type Term (Control Section 
Name)"), or by the length indicated on an 
ICS card (see "Include Control Section 
Card"); or it may be set to a definite 
value by an SLC card (see "Set Location 
Counter Card"). Each time LOCCTR is incre- 
mented, the new value is compared with the 
low-order address of the loader tables to 
prevent these tables and the loader program 
from being overlaid. If an attempt is made 
to overlay the tables and loader program, 
an error halt occurs. After loading, how- 
ever, when control has been transferred to 
the program loaded, the space occupied by 
the loader tables and program is available 
and may be overlaid. 



SPECIAL RELLDR FUNCTIONS 

RELLDR has not only the three functions 
of ABSLOD, that is, loading, correcting, 
and transferring control, but also the 
special functions described with their 
associated load cards in Table 15. 



Table 15. Special RELLDR Functions 
r 



FUNCTIONS 



CARDS 



Relocating ; Can place the instructions 
and constants of a control section into 
storage locations other than those as- 
signed by the assembler; that is, relo- 
cate them. 



Set Location Counter (SLC) 
Include Control Section (ICS) 
External Symbol Dictionary 

(ESD type term) 
Text (TXT) , Replace (REP) 



Linkage ; Loads two or more control sec- 
tions one after the other and completes 
linkage among them so that one control 
section may refer to constants or in- 
structions, or both, within another; 
makes any changes necessary to evaluate 
address constants of up to four bytes 
which are used by the control section. 



External Symbol Dictionary 
(ESD type 1 and 2 terms) 

Relocation List Dictionary 
(RLD) 

Replace (REP) 



Transferring Control : Ends loading and 
causes control to be transferred accord- 
ing to the priority noted in the dis- 
cussion of the LDT card. 



Load End (END) 
Load Terminate 



(LDT) 



Note : The function of the REP card is essentially the same as in ABSLOD. 
The END card remains an essential part of each control section, but 
is subordinate in function to the LDT card. 
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LOADER TABLES 

To relocate assembled addresses and to 
link the various modules or control sec- 
tions, the loader uses three tables, 
referred to as the Dictionary, the Ref- 
erence Table, and the Relocation List. 
These tables are built before storage just 
before RELLDR, overlaying ABSLOD, which is 
no longer required. 

The Dictionary is used to list the 
symbolic names of all the control sections, 
entry points, and external symbols as they 
are encountered during the entire loading 
process, and their relocated addresses when 
they are known. 

The Reference Table is used to relocate 
all the assembly addresses of a control 
section and to calculate, when possible, 
the value of the load constants in that 
section. Any load constant whose value 
cannot be calculated because the relocated 
address of the symbol to which it refers is 
not yet known, is placed in the Relocation 
List until it can be calculated. 

When an END card is encountered, the 
Reference Table is cleared in preparation 
for the next control section, and the 
Relocation List is scanned to calculate the 
value of any load constants for which the 
relocated address of the related symbol is 
now known. 



LOADER CARDS 

The formats of the eight types of load 
card recognized by RELLDR are described in 
detail in the following sections, together 
with the manner in which each type of card 
is processed by the loader. 

Set Location Counter Card 

The Set Location Counter (SLC) card sets 
the location counter to an address indicat- 
ed in one of three ways : 

1. Any absolute address specified as a 
hexadecimal number punched in card 
columns 7-12. 

2. Any symbolic address already defined 
as a control section name or entry 
point. This is specified by a symbol- 
ic name punched in card columns 17-22. 

3. The sum of the absolute address in 
card columns 7-12 and the internal 
address of the symbolic name in card 
columns 17-22, if both these fields 
are specified. 

If only one field is used, the other 
must be left blank. If both fields are 



blank, the SLC card is ignored and a 
warning message is issued. If the SLC card 
causes LOCCTR to be decremented, a warning 
message is also issued as LOCCTR is set to 
the new value. 

The SLC card is normally placed in front 
of the control section to which it applies, 
but it will be recognized at any point 
within an assembled control section. 

The contents of the SLC card fields are 
defined in Table 16. 

Table 16. Set Location Counter Card 

1 

CONTENTS I 



r T" 

j COLUMN I 

v +- 



Load card identification 
(12-2-9 punch). Identifies 
this as a card acceptable to 
the loader. 



2-4 

5-6 
7-12 



13-16 
17-22 



23-72 
73-80 



SLC. Identifies 
load card. 

Blank. 



the type of 



Address in hexadecimal (to be 
added to the value of any sym- 
bol specified in columns 
17-22) . The address must be 
right- justified in these 
columns. Unused columns are 
filled with zeros. 

Blank. 

Symbolic name (may be blank) 
whose internal assigned loca- 
tion will be used by the load- 
er. The symbol must be left- 
justified in these columns. 
Unused columns are left blank. 

Blank. 

Not used by the loader. 



Include Control Section Card 

The Include Control Section (ICS) card 
is used to reserve storage space for a 
control section which will be loaded later. 
The card specifies the name and the length 
of the control section. 

Control sections are loaded only on 
double-word boundaries. The loader auto- 
matically makes this adjustment before 
loading any given control section, in the 
following manner: 

1. The location counter is adjusted, if 
necessary, to the next double-word 
boundary . 
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The symbolic name is stored in the 
Dictionary, with the current value of 
the location counter. 



3. The length of the control section is 
added to the value of the location 
counter and the latter is set to the 
resulting sum to reserve the storage 
area. 

Later, when the loader encounters a 
reference to this control section, its 
location is already known; and when the 
control section is loaded, it will be 
placed in the area of storage reserved for 
it. 

The loader does not retain the length of 
the control section given by the assembler 
in the ESD type term; therefore, the 
length specified in the ICS card must not 
be less than that specified in the ESD type 
term. If it is, the control section 
concerned will overlap the next one in 
storage. Storage space may be reserved for 
REP cards by specifying a greater length in 
the ICS card. A warning message is issued 
if the length stated in the ICS card 
differs from that in the ESD type term. 

ICS cards are normally placed before the 
first card of a control section, but they 
will be recognized at any point within an 
assembled control section. 

The contents of the ICS card fields are 
defined in Table 17. 

Table 17. Include Control Section Card 



r t- 

I COLUMN I 



CONTENTS 



Load card identification 

(12-2-9 punch). Identifies 
this as a card acceptable to 
the loader. 

2-4 I ICS. Identifies the type of 
load card. 

5-16 I Blank. 

17-22 I Name of control section, left- 
justified. 

23-24 | Blank. 

25-28 | Length (in bytes) of the 
control section, in hexadecimal 
notation, right- justified. 

Unused leading columns are 
filled with zeros . 

29-72 | Blank. 

73-80 I Not used by the loader. 



External Symbol Dictionary Card 

The External Symbol Dictionary (ESD) 
cards are generated by the assembler. 
These cards may contain three types of 
term: 

1. The ESD type term defines the name, 
the assembled starting address, and 
the length of a control section. It 
is produced by the assembler when it 
encounters a START instruction. Only 
one ESD type term is produced per 
control section, and it is assigned an 
external symbol identification (ESID) 
of 01. 

2. The ESD type 1 term defines an entry 
point within the control section to 
which another section may refer. One 
ESD type 1 term is produced by the 
assembler each time it encounters an 
ENTRY instruction. 

3. The ESD type 2 term points to a name 
within another control section to 
which this section may refer. One ESD 
type 2 term is produced by the assem- 
bler each time it encounters an EXTRN 
instruction, and is assigned an ESID 
of from 02 onwards, in the order in 
which it is encountered among the 
external symbols of the control sec- 
tion being assembled. 

The variable field on the ESD card may 
contain up to three terms, which may be of 
the same or of mixed type. The contents of 
the common fields of the ESD card are 
defined in Table 18; the contents of the 
variable field will be discussed under each 
type of term. 



ESD Type Term (Control Section Name) 

This term defines the name, or entry 
point, of the control section. It is 
produced by the assembler when it encount- 
ers a START instruction. If the START 
instruction does not specify a control 
section name, blanks will be placed in the 
Dictionary to define that "name." 

The assembler assigns an external symbol 
identification of 01 (ESID 01) to the 
control section. This number is used by 
the loader as a pointer to the Reference 
Table entry. This entry is created by the 
loader when it processes the ESD type 
term, and contains the address of the 
control section name in the Dictionary and 
the address at which it was assembled. The 
ESID 01 appears in the ESD type term, in 
all the ESD type 1 terms, and in all TXT, 
RLD, and END cards produced by the assem- 
bler. The loader can thus calculate the 
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Table 18. External Symbol Dictionary Card 

r r 1 

I COLUMN | CONTENTS 



Load card identification 
(12-2-9 punch). Identifies 
this as a card acceptable to 
the loader. 



2-4 

5-10 
11-12 

13-14 
15-16 

17-64 



65-72 
73-80 



ESD. Identifies the type of 
load card. 

Blank . 

Number of bytes in the variable 
field (card columns 17-64), in 
extended card code. 

Blank . 

ESID of the first ESD type or 
2 term, if any, in the card. 

Variable information field con- 
taining from one to three 
16-column terms (see Tables 19, 
20, and 21). Unused columns 
are left blank. 

Blank. 

Not used by the loader. 



control section's relocation factor when- 
ever it is needed; this factor is the 
difference between the address where the 
control section is loaded (recorded in the 
Dictionary) and that at which it was 
assembled (recorded in the Reference 
Table) . 

The address at which the control section 
will be loaded is determined by the follow- 
ing conditions: 

1. If the name of the section defined by 
the ESD type term is already in the 
Dictionary, then the section will be 
loaded at the location specified in 
the Dictionary, and no adjustment is 
made to the location counter. 

2. If the name of the control section 
defined in the ESD type term is not 
in the Dictionary, then: 

a. The location counter is adjusted, 
if necessary, to the next double- 
word boundary. 

b. The control section name is placed 
in the Dictionary, with the 
current value of the location 
counter. 



section, and the section will be 
loaded at the value now specified 
in the Dictionary. 



The loader loads only one control sec- 
tion at a time and clears all entries in 
the Reference Table when it encounters an 
END card. Since it does not save the ESIDs 
from one section to another, there is no 
conflict in the Reference Table when the 
next section is assigned the same number 
(ESID 01) . 

The contents of an ESD type term are 
defined in Table 19. 



Table 19. ESD Type Term 

CONTENTS 



r T" 

| COLUMN | 



1-6 I Control section name. 
7-8 I Blank. 

9 | Extended card code 12-0-1-8-9 

(hexadecimal 00) , identifying 
this as an ESD type term. 

10-12 I Address, in extended card code, 
of the first byte of the con- 
trol section as assigned by the 
assembler. 

13 | Blank. 

14-16 | Length, in bytes, of the con- 
trol section (extended card 
code) . 



j 



ESD Type 1 Term (Entry Point) 

This term defines an entry point within 
the control section to which another sec- 
tion may refer. One such term is produced 
by the assembler each time it encounters an 
ENTRY instruction. All ESD type 1 terms 
are assigned the same ESID as that of the 
ESD type term of the same control sec- 
tion. 

The loader processes ESD type 1 terms by 
scanning the Dictionary to see whether the 
entry point has already been defined as an 
external symbol in another control section. 
If it has, the relocated address is now 
calculated and placed in the Dictionary 
against the name; if not, a new entry 
containing the name and the relocated 
address of the program entry point is 
created. 



c. The location counter is increment- 
ed by the length of the control 



The contents of an ESD type 1 
defined in Table 20. 



term are 
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Table 20. ESD Type 1 Term 

CONTENTS 



r t- 

| COLUMN I 



Table 21. ESD Type 2 Term 

CONTENTS 



r t 

| COLUMN j 



1-6 I Name of entry point. 
7-8 | Blank. 

9 I Extended card code 12-1-9 

(hexadecimal 01) , identifying 
this as an ESD type 1 term. 

10-12 | Address, in extended card code, 
of the entry point as assigned 
by the assembler. 

13-14 | Blank. 

15-16 | ESID, in extended card code, 
assigned to the control section 
in which the entry point 
occurs. 



ESD Type 2 Term (External Symbol) 

This term points to a name within anoth- 
er control section to which this section 
may refer and is produced by the assembler 
when it encounters an EXTRN instruction. 
One term is produced for each external 
symbol thus defined and assigned an ESID of 
from 02 onwards as it is encountered in the 
program. This number is used as a pointer 
to the Reference Table entry and appears in 
the RLD card associated with that external 
symbol . 

The loader processes an ESD type 2 term 
by scanning the Dictionary to see whether 
the external symbol has already been 
defined as an entry in another control 
section. If it has not, the symbol is 
entered in the Dictionary but the address 
is left blank. A Reference Table entry is 
then created which contains the address of 
the symbol in the Dictionary. 

The loader loads only one control sec- 
tion at a time and clears all entries in 
the Reference Table when it encounters an 
END card. Since it does not save the ESIDs 
from one section to another, there is no 
conflict in the Reference Table when the 
next section is assigned the same numbers 
(02, 03, etc.). 

The contents of an ESD type 2 term are 
defined in Table 21. 

Text Card 

The Text (TXT) card is generated by the 
assembler. It contains the instructions 
and constants of the program to be loaded, 
and the address at which the first byte of 
text in the card is to be loaded. Each 
card contains a maximum of 56 bytes of text 
in extended card code. 



-I h 



— I 



1-6 I Name of external symbol. 

7-8 I Blank. 

Extended card code 12-2-9 
(hexadecimal 02), identifying 
this as an ESD type 2 term. 

10-12 | Extended card code 12-0-1-8-9 
(hexadecimal 00) , three times. 
The address assigned to an 
external symbol by the assem- 
bler is always zero. 

13-16 | Blank. 

L ± 



The loader relocates the address in the 
card by the relocation factor of the con- 
trol section to which the card belongs, and 
stores the contents of the card at that 
address. 



The contents of the TXT card fields are 
defined in Table 22. 



Table 22. 



Text Card 



r t- 

I COLUMN I 



CONTENTS 



Load card identification 
(12-2-9 punch) . Identifies 
this as a card acceptable to 
the loader. 



2-4 

5 

6-8 

9-10 
11-12 

13-14 
15-16 

17-72 

73-80 



TXT. Identifies the type of 
load card. 

Blank. 

Address, in extended card code, 
at which the information on the 
card is to be loaded. 

Blank. 

Number of bytes of text in the 
card, in extended card code. 

Blank . 

External Symbol Identification 
(ESID) assigned to the control 
section in which the text 
occurs (in extended card code) . 

A maximum of 56 bytes of 
instructions and constants 
assembled in extended card 
code. 

Not used by the loader. 
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Relocation List Dictionary Card 

The Relocation List Dictionary (RLD) 
card is produced by the assembler when it 
encounters a DC instruction or the second 
operand of a CCW instruction which defines 
an address as a relocatable symbol or 
expression. This may be the address either 
of an internal symbol which occurs only 
within the control section or of an exter- 
nal symbol belonging to another section. 



The contents of the RLD card fields 
defined in Table 23. 



are 



The loader uses position and relocation 
headers (see Table 23) to enter the Ref- 
erence Table and the Dictionary. It calcu- 
lates the relocated address of the load 
constant and the value of the expression. 
If the latter cannot be computed because 
the relocation header refers to a symbol 
which has not been loaded yet, the loader 
places the loading address and the reloca- 
tion headers of the load constant in the 
Relocation List. The loader scans the 
Relocation List at the end of each control 
section and finishes processing load con- 
stants which refer to symbols defined in 
that control section. 



Table 23 . Relocation List Dictionary Card 



r T - 

I COLUMN I 



CONTENTS 



Load card identification 

(12-2-9 punch). Identifies 
this as a card acceptable to 
the loader. 



the type of 



2-4 I RLD. Identifies 
load card. 

5-10 I Blank. 



11-12 | Number of bytes of information 
in the variable field (card 
columns 17-72), expressed in 
extended card code. 

13-16 | Blank. 

17-72 | Variable field in extended card 
code, consisting of the follow- 
ing subfields: 



Relocation Header . 



Two- byte 



ESID of the symbol in the load 
constant. The ESID is 01 if 
the symbol is internal to the 
control section, and greater 
than 01 if it is external. 

(continued) 



Table 23. Relocation List Dictionary Card 
(continued) 



T - 

COLUMN | 



CONTENTS 



Position Header . Two-byte ESID 
assigned to the control section 
in which the load constant 
appears . 



— I 



Flag Byte , 
not used. ) 
three items: 



(Bits 
This byte 



to 3 are 
contains 



1. Size. 



Bits 4 and 5 indi- 
cate the length in bytes of 
the load constant as fol- 
lows: 

00 - one byte 

01 - two bytes 

10 - three bytes 

11 - four bytes 

2. Complement flag . When bit 
6 is a one, the value of 
the symbol must be sub- 
tracted from the expression 
in which it occurs. When 
bit 6 is zero, the value 
must be added. 

3. Continuation Flag . When 
bit 7 is a one, it means 
that this is one of a ser- 
ies of expressions to be 
derived from the value of 
one symbol. When bit 7 is 
a zero, it means that this 
is the only expression, or 
the last expression, to be 
derived from the value of 
one symbol. 

Address . Three-byte address of 
the expression given by the 
assembler, in extended card 
code. 

The flag-byte and address 
fields may be repeated for 
other expressions as long as 
the continuation flag is on in 
the current four-byte entry. 

73-80 | Not used by the loader. 

L A J 

Replace Card 

Replace (REP) cards are produced by the 
programmer to substitute new text for por- 
tions of assembled text. They must be 
placed immediately after the last TXT card. 
Assembled instructions or constants, or 
both, are replaced byte for byte by the 
instructions or constants punched in the 
card in hexadecimal code. A REP card may 
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contain a minimum of 2 bytes (one 
half-word) and a maximum of 22 bytes. The 
assembled address of the first byte of text 
to be replaced, which must be stated in the 
card, will be relocated by the loader. 

If additions made by REP cards increase 
the length of a control section, an ICS 
card must be placed at the front of the 
control section to define the new length of 
the section. 



The contents of the REP card fields 
defined in Table 24. 



Table 24. Replace Card 

CONTENTS 



are 



r t- 

I COLUMN I 



Load card identification 
(12-2-9 punch). Identifies 
this as a card acceptable to 
the loader. 

2-4 | REP. Identifies the type of 
load card. 

5-6 | Blank. 

7-12 | Address, in hexadecimal, of the 
area to be replaced. It must 
be right- justified and unused 
leading columns must be filled 
with zeros. The address must 
specify a half-word boundary. 

13 I Blank. 

14-16 | External Symbol Identification 
(ESID) , in hexadecimal, 

assigned to the control section 
in which the replacement is to 
be made. If this number is not 
known, the field must be filled 
with zeros. 

17-70 | A maximum of eleven 4-digit 
hexadecimal fields, separated 
by commas, each replacing one 
previously loaded half-word (2 
bytes). The last field must 
not be followed by a comma. 

71-72 | Blank. 

73-80 j Not used by the loader. 



Load End Card 

The Load End (END) card is produced by 
the assembler when it encounters the END 
instruction; it ends loading of the control 
section and may specify a location within 
the section to which control should be 
transferred. When the loader encounters 
this card, it clears the Reference Table 



and scans the Relocation List to finish 
processing any load constants related to 
symbols which have been defined in the 
control section just loaded. 

The contents of the END card fields are 
defined in Table 25. 



Table 25. 



r t- 

I COLUMN I 



Load End Card 

CONTENTS 



2-4 



6-1 



Load card 
(12-2-9 punch) 
this as a card 
the loader. 

END. Identifies 
load card. 



identification 
Identifies 
acceptable to 



the type of 



-H 



9-14 
15-16 

17-72 
73-80 



Blank. 

Address (may be blank) , in 
extended card code, of the 
point in the control section to 
which control may be trans- 
ferred at the end of the load- 
ing process. See priority con- 
ditions discussed under the LDT 
card. 

Blank. 

External Symbol Identification 
(ESID) of the control section. 

Blank . 

Not used by the loader. 



Load Terminate Card 

The Load Terminate (LDT) card must be 
placed at the end of the input deck. It 
has two uses: 

1. It ends the loading process. 

2. It causes control to be transferred to 
some location within the section or 
sections loaded. 

The contents of the LDT card fields are 
defined in Table 26. 

When the loader encounters the LDT card, 
it scans the Dictionary to see whether all 
the symbols have a loading address; that 
is, whether they have been defined, and if 
they have not, it issues a warning message. 

The loader then checks whether any 
errors have been detected during loading, 
and if so, it causes a message to be 
printed and the system to enter the wait 
state. 
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Table 26. Load Terminate Card 

CONTENTS 



r t- 

I COLUMN! 



Load card identification 

(12-2-9 punch) . Identifies 
this as a card acceptable to 
the loader. 



2-4 

5-16 
17-22 



LDT. Identifies 
load card. 

Blank. 



the type of 



23-72 
73-80 



Name of the symbolic entry 
point to the loaded program in 
standard card code, left-* 
justified. This field may be 
blank . 

Blank . 

Not used by the loader. 



If no errors have occurred during 
loading, the loader transfers control to a 
location determined by the following order 
of priority: 



1. 



2. 
3. 

4. 



The Self-Loading Program Generator 
routine if the CALL card specified 
that an initialized self-loading ver- 
sion of the program be produced on 
magnetic tape or punched cards 

Any location specified in the LDT card 

The first location specified by an END 
card encountered during the current 
loading process 



The first byte of the first 
section loaded by RELLDR 



control 



After control has been transferred to 
the loaded program, the system operates in 
the problem state, enabled for all inter- 
ruptions. If a program check occurs, the 
program new PSW causes the loader to issue 
a message and to set System/360 in the wait 
state. This is true only as long as RELLDR 
has not been overlaid, nor the program new 
PSW altered, by the program being executed. 



CARD SEQUENCE 

The following list shows the sequence of 
cards in a series of control sections ready 
to be loaded by RELLDR; it does not show 
all the permissible combinations. 

SLC sets the location counter at an 
absolute address. 

ICS defines control section B as a sec- 
tion to be loaded later and speci- 



ESD 



TXT 



REP 



RLD 



END 



ESD 



TXT 



RLD 



END 



LDT 



f ies 
it. 



the length to be reserved for 



defines the name and length of sec- 
tion A (type term) , any entry 
points in section A to which section 
B may refer (type 1 term) , and any 
external symbols in section B to 
which section A refers (type 2 
term) . 



contains instructions and 
of section A. 



constants 



contains changes or additions to 
section A. 

contains information for evaluating 
relocatable addresses in section A. 

can contain an address within sec- 
tion A to which control will be 
transferred after loading if no 
address is given in the LDT card. 

defines the name and length of sec- 
tion B (type term) , any entry 
points in section B to which section 
A may refer (type 1 term) , and any 
external symbols in section A to 
which section B refers (type 2 
term) . 



contains instructions and 
of section B. 



constants 



contains information for evaluating 
relocatable addresses in section B. 

can contain an address within sec- 
tion B to which control will be 
transferred after loading if no 
address is given in the LDT card nor 
in the previous END card. 

ends the loading process. If this 
card specifies an address for trans- 
fer of control, this overrules any 
address saved or specified by an END 
card. 



OTHER FEATURES 

In addition to its basic functions, 
RELLDR can be used for absolute loading. 

RELLDR cannot implement the overlaying- 
load procedure for programs larger than 
available storage. 



Loading in Absolute Form 

If the ESD cards are removed from the 
control section before loading, RELLDR 
operates in a manner similar to ABSLOD. 
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The loader will load one or more control 
sections, either in absolute form or in 
both absolute and relocatable form, until 
it encounters an LDT card. However, the 
following restrictions apply : 

1. The loader will not record in the 
loader tables the presence of a con- 
trol section loaded in absolute form. 

2. No linkage is provided with any sec- 
tion loaded in absolute form; there- 
fore, if the user wishes to load a 
section at the location assigned by 
the assembler and have linkage with 
another section, he must specify the 
starting address with an SLC card and 
leave in the ESD cards. 

3. If two or more control sections are 
loaded in absolute form, any common 
addresses in these sections will be 
overlaid. 

The location counter setting depends on 
the SLC, ICS, and ESD (type term) cards 
read during loading. If the control sec- 
tion to be loaded in absolute form is the 
first one, the location counter contains 
the address of the first storage location 
following the unit control blocks created 
by INIT. To avoid overlaying programs that 
have already been loaded, an absolute load- 
ing address must not be lower than the one 
contained in the location counter, nor 
greater than that of the start of the 
loading tables. 



Selective Loading 

The selective loading function saves 
storage space by loading only those parts 
of the Simulator which are necessary to 
simulate a particular installation. 

Optional sections have two control sec- 
tion names, one defining the complete con- 
trol section, the other defining a dummy or 
a shorter version of the section. Depend- 
ing on the options specified in the CALL 
card, which are translated into the 
appropriate control section names by INIT, 
RELLDR will load one or the other section. 
When the loader is initialized, it creates 
a loading table (LDOPT) of control sections 
that must not be loaded. 

Both control sections of any optional 
portion of the program must conform to the 
following requirements : 

1. Their names must be different and no 
reference must be made to these names 
in any other portion of the Simulator. 

2. They must contain the same number of 
entry points with the same names to 



avoid leaving any external symbols in 
other sections undefined. 

3. They must be assembled separately, 
each one on its own. 



SELF-LOADING PROGRAM GENERATOR ROUTINE 

This routine is entered from RELLDR if 
the term "INIT=nnnnnn" was present in the 
CALL card processed by INIT ("nnnnnn" being 
the symbolic name of the output device) . 
It creates a punched card deck or a magnet- 
ic tape file in a form which can be loaded 
by the System/360 IPL procedure. This card 
deck or tape file contains the contents of 
main storage between locations 24 and the 
last byte loaded by RELLDR (LOCCTR-1) ; that 
is: 

• CONTPR 

• IOPACK 

• The program just loaded (specified in 
the CALL card) 

Since CONTPR and IOPACK are needed to 
create the card deck or tape, the routine 
first copies this storage area into main 
storage beyond location LOCCTR. 

The magnetic tape file consists of: 

1. A 24-byte IPL record containing a PSW 
and two CCWs 

2. A variable-length record containing a 
copy of the storage area concerned 

The card deck consists of : 

1. A 24-byte IPL card containing a PSW 
and two CCWs 

2. A 56-byte IPL card containing a boot- 
strap loader made up of seven chained 
CCWs 

3. As many TXT cards as are required to 
contain the storage area concerned 

4. An END card to exit from the bootstrap 
loading loop and terminate the IPL 
procedure 

The Self- Loading Program Generator rou- 
tine ends by issuing one of the following 
messages and setting System/360 in the wait 
state : 

1. A212A END OF INITIALIZATION - This is 
the normal end of the routine. 

2. A213W INITIALIZATION ERROR, CANNOT 
CONTINUE - This message is issued if 
the area of storage between LOCCTR and 
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the beginning of this routine in main 
storage is too short to contain the 
copy of locations 24 to LOCCTR-1. 



LINKAGE WITH CONTPR AND IOPACK 

RELLDR uses CONTPR and IOPACK for all 
input/output operations, including mes- 
sages. The linkage between these subpro- 
grams and RELLDR is discussed in the sec- 
tions "Control Program" and "I/O Support 
Package. " 



RELLDR MESSAGES 

RELLDR can produce off-line messages for 
the programmer if the parameter LIST is 
added to the CALL card after the other 
parameters it may contain. Under normal 
conditions, no messages are needed, or 
printed; the parameter LIST should be 
inserted in the CALL card only if loading 
does not terminate correctly to determine 
why during another attempt; in this case, 
the CALL card has the following format: 

/ CALL EDITOR, LIST 

The messages are recorded on the support 
device identified by the symbol SIM2PRNT, 
defined in a DEVSUP control card before 
EDITOR was loaded, and are classified under 
three headings: 

Information These messages are for informa- 
tion only, giving, for 
instance, the addresses at 
which the various control sec- 
tions start. 

Warning These messages draw attention 

to possible recoverable errors 
which may occur but do not 
interrupt loading. 

Error These messages indicate any 

errors such that loading cannot 
continue. 

In the following messages "xxxxxx" rep- 
resents one of the following: 

• A symbolic name 

• The identification number punched in 
card columns 73-80 

• The serial number of the card in the 
deck if columns 73-80 are blank 

The term "card" refers either to an 
actual card or to a tape record in the form 
of a card image. 



Informative Messages 

RL00I xxxxxx CONTROL SECTION LOADED 
AT 

The first byte of the control sec- 
tion identified by the symbol 
"xxxxxx" is loaded at the address 
stated. 

RL01I * INITIAL PSW 

This is the PSW which transfers 
control to the program loaded. 

Warning Messages 

RL02I xxxxxx ILLEGAL CARD IN LOADER INPUT 
The card indicated was not recog- 
nized by the loader and was ignored. 

RL03I XXXXXX TXT FOLLOWS REP OR RLD CARD 

The TXT card indicated was out of 
sequence. The loader processed the 
card, but part of the control sec- 
tion loaded may have been overlaid. 

RL04I XXXXXX ADDRESS OUTSIDE C.S. OR C.S. 
ALREADY LOADED 

The address contained in the TXT or 
REP card indicated is beyond the end 
of the control section being loaded 
or in a preceding control section 
already loaded. The card was 
ignored. 

RL05I xxxxxx TXT CARD CONTAINS MORE THAN 
56 BYTES 

The loader stores as many bytes as 
are stated in card columns 11-12, 
but this may cause a program error 
at a later stage. This message will 
occur only if an error is made when 
correcting or repunching a TXT card. 

RL06I xxxxxx TEXT OVERLAYS LOADER TABLES 

The control section being loaded is 
longer than stated in the ESD card 
(type term) or the ICS card and 
overlays the start of the loader 
tables. This message can occur only 
if the end of the control section 
has been modified by REP cards. The 
card indicated was ignored. 

RL07I xxxxxx ESD CARD FOLLOWS TXT CARD 

The card indicated was out of 
sequence and was ignored. 

RL08I xxxxxx USED AS ENTRY AND CONTROL 
SECTION NAME 

The symbol in the card indicated, 
already defined in an ESD type 1 
term, has been found in an ESD type 
term or vice versa. This might be 
a source of error. 

RL09I xxxxxx CONTROL SECTION DEFINED WITH 
2 LENGTHS 

The control section defined in the 
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card indicated has been previously 
defined with a different length by 
an ESD type term or an ICS card. 
The new definition was ignored. 



RL10I xxxxxx LDT CARD NOT PRECEDED BY END 
CARD 

The last control section loaded did 
not contain an END card. The loader 
assumed that there was one but that 
it did not specify any transfer 
address . 

RL11I xxxxxx EXTERNAL SYMBOL HAS NO REAL 
DEFINITION 

The symbol shown, which was recorded 
as an external, does not correspond 
to any entry point or control sec- 
tion name. This message is printed 
after the LDT card has been read. 

RL12I xxxxxx BLANK OR COMMA MISSING IN REP 
CARD 

The REP card indicated does not 
conform to the standard format and 
was ignored. 

RL13I xxxxxx ADDRESS OF SYMBOL IN SLC CARD 
NOT RELOCATED 

The symbol in the SLC card indicated 
has not been defined yet, has not 
been relocated yet, or does not 
exist. In the first two cases, the 
SLC card is out of sequence; in the 
last, the symbol is erroneous. The 
card was processed as though no 
symbol were specified. 

RL14I xxxxxx NEITHER NAME NOR ADDRESS IN 
SLC CARD 

Since the SLC card indicated con- 
tained no data, it was ignored. 

RL15I xxxxxx SLC HAS SET LOC. CNTR. TO 
VALUE ALREADY LOADED 

The updated value of the location 
counter is smaller than the previous 
one, therefore all or part of the 
control section previously loaded 
may be overlaid. 

RL16I XXXXXX CHARACTER IN CARD NOT HEXA- 
DECIMAL 

The card indicated, which may be a 
REP, an SLC, or an ICS card, con- 
tains a non- hexadecimal character in 
a field which must be hexadecimal. 
The card was ignored. 

RL17I xxxxxx ENTRY POINT IS REPEATED 

The symbol contained in the card 
indicated has already been defined 
as an entry point . The card was 
ignored. 

RL18I xxxxxx ENTRY POINT NOT RELOCATABLE 

The address of the entry point on 



the card indicated cannot be relo- 
cated within the limits of the con- 
trol section to which it belongs. 
This can arise only if the card was 
punched by hand and a mistake was 
made in calculating or punching the 
address. The loader relocates the 
entry point at address 0. 

RL19I xxxxxx ADDRESS NOT RELOCATABLE 

This message applies only to RLD 
cards and means that the address of 
a constant in the card cannot be 
relocated within the limits of the 
control section to which it belongs, 
or that the control section has 
already been loaded. The first case 
is due to an error in hand-punching 
a card, the second indicates that 
the control section has been repeat- 
ed by error on the tape or in the 
card deck. 



RL20I xxxxxx EOF BEFORE END OF LOADING 

No LDT card was found at the end of 
the file. The loader assumes that 
there was one but that it did not 
contain a transfer address, and ends 
loading accordingly. 



Error Messages 

RL21W XXXXXX INSUFFICIENT SPACE FOR LOADER 
TABLES 

The area of main storage reserved 
for the loader tables is too small. 
The length of this area was speci- 
fied in the card preceding the first 
module or control section to be 
loaded. This message occurs only if 
the user has modified the Simulator 
system delivered by IBM. 

RL22W xxxxxx INSUFFICIENT SPACE AVAILABLE 
FOR THE PROGRAM 

This message may be due to an SLC 
card with too high an address, or it 
may occur if the space for the 
loader tables has been increased by 
the user to such an extent that 
there is not enough storage left to 
accommodate the program. In the 
latter case, if the loader table 
size cannot be reduced, RELLDR will 
have to be moved further on in 
storage. 

RL23W xxxxxx PROGRAM ERROR 

This message occurs only if part of 
the support programs (CONTPR or 
IOPACK) has been accidentally over- 
laid during loading, for instance as 
a result of an erroneous SLC card. 
The card which was being loaded at 
the time the program error occurred 
is identified in the message. 
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Chart FA. Overall Logic of ABSLOD 



INITIAL ENTRY ROUTINE- 
ENTER ONLY ONCE DURING 
LOADER RESIDENCE. WHEN THE 
LOADER PROGRAM IS EXECUTED LENTRY 



»****A3********** 

PREPARE PSWS * 
FOR MACHINE * 
CHECK AND * 
PROGRAM * 
CHECK * 
**************** 



LENTRE X 

*****B3********** 

* SET UP LOADER * 

* WITH * 

* APPROPRIATE * 

* LOADER INPUT * 

* DEVICE * 
***************** 



ENTER EACH TIME A CARD OR 
CARD IMAGE MUST BE READ 
DURING LOADER EXECUTION 



CLEAR X 

*****C3******* 

* CLEAR STORAGE 
*FROM 386 TO END 

* EXCEPT FOR * 
♦LOADER PROGRAM* 

* AREA * 
************** 



X. . 



GETCRD X 

*****D3********* 

* CARD ANALYSIS 

* ROUTINE - 

* READ CARD OR 

* CARD IMAGE 

* ON TAPE 



TXT *. YES 

•*•••• 

CARD .* 



REP 
CARD 



END 
CARD 



LDR *. YES 

CARD .* 



PLACE TEXT 
IN STORAGE 
************** 



****F4«* ******** 
CONVERT CARD * 
TO TXT CARD * 

**************** 



* SAVE TRANSFER 
<* 

* ADDRESS 
* 

**************** 



* H * 
►FREEZE LOCATION* 

* * 

* COUNTER * 

* * 
***************** 



J3 *. ***** J4******»*« 

*. * SET UP DATA 

LDT *. YES * FOR 

.* X* INITIALIZATION 

CARD .* * PROGRAM 

*. .* **************** 



*****K3******** 

.* IGNORE CARD 
* 

*************** 
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Chart FB. Overall Logic 



Of CONTPR 



.* SVC *. 
0.3.5.6,7 «. YES 
8,9,10.15 .*.... 
16.19 .* 



» 0.3.5,6,7.8,9 * 
« 10.15.16,19 » 
«-*#******•»«**«*** 



»C3********-« 



»****#*****♦»»-** 



1,2,4,11.13 14 



*e**Fl***-****« 

I/O 

INTERRUPTION 



f INTERRUPTION 
» RECEIVER 



*****H2*********» H3 ». 

►SENSE ROUTINE * .* *. 

»-*-*-»-*-*-*-*-*EXCEPT I ONAL* STATE 

* PICK *X. ». OF CHANNEL 

»UP SENSE BYTES "CONDITION *. 



H* *. 

It 

SVC 1 1 



CHAIN I/O * 
REQUEST AND * 
CONTINUE * 
*#«*#*******#*« 



*TRY TO INITIATE* 
♦CHAINED OPN ON * 
* CHANNEL * 

**#**»*♦»»»***»»* 



» WAIT 
*«***#«**« 
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Chart FC. 



I/O Request and Continue (Part 1) 



*FC * ENTRY FOR 
♦ B2* SVC 2 
* » SEQUENCE 



X 

»»*»»Q2 **»»»»»»»* 
♦GETUCB » 
»_«_#_*_»_»_#_»_» 
* GET » 

» INDEX PAIR » 
» (J.K) » 

•••••••*•••••*••• 



X 

C2 ». 
• * ♦• 
NO .* INDEX *. 
...*. PAIR FOUND .* 
*. .* 
*• • * 

*. .* 
* YES 



X 

*****»D2 »*♦*»»#♦**» 

STRTIO 



TRY TO 
» START I/O * 

OPERATION ««*» 
*••*»*••*•*•* • * 



CHANNEL END 



PATH BUSY 



**«**K2 »♦*»*»♦♦»* 

* DISABLE AND » 

* RETURN TO » 

K* CALLER AT »... . 
♦ADDRESS EXCRET » 

* * . 
»*»»*♦■*»»*»»##»»♦ x 



* * 

* RETURN TO * 
<• CALLER AT *. 

♦ADDRESS ACCRET » 

* » 
♦•***•♦*•••••«**• 



»***»G3»*»******* 

• * 

* RETURN TO * 
<♦ CALLER AT ». 

♦ ADDRESS I » 

♦ ♦ 
♦♦♦•♦*••♦••****** 



* ADD I/O *. 

♦ REQUEST TO ♦ 
» CHANNEL CHAIN « 
»♦***#-»*♦****•*♦* 



♦ ♦♦**j3**#*«-**#** 

♦ DISABLE AND ♦ 

♦ RETURN TO » 
C» CALLER AT ♦. 

•ADDRESS NRMRET ♦ 

♦ * 
****«»»***»»*♦»*» 



.X^ E3 
«**« 
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Chart FD. I/O Request and Continue (Part 2) 



*FO * ENTER HERE 

* B2» WHEN I/O 

*. * INTERRUPTION 

* OCCURS 



X 

•*»**B2 *****#»»#* 

•GETUCB * 



» GET * 

* INDEX PAIR » 

* (J.K) * 
****»***»*#»#*##♦ 



EXAMINE 
INTERRUPTION 
CONDITIONS 



SET RETURN 
ADDRESS = 
EXCRET 



* NO 

(SENSE. CHEND. 
OTHER) 



* START ANY »> 
•WAITING I/O FOR* 

* THIS CHANNEL * 
***#******«-**«##* 



RETURN TO 
CALLING 
PROGRAM 
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Chart 



FE. UNSTAK Routine 



***** 

•FE * 
» Bl* 
* * 



**** 

* » 
» B3 * 

* * 
»#»» 



ENTER X 

***»*B1 ******* 
» SET * 

* POINTER * 
..X*=IOQBEG(K) SET » 

* UNSTSW •OFF 1 * 
» * 
************** 

•••• 

* CI *.x. 

* * 
**** 

X 

**»**C1 ********** 

* * 

* PICK UP * 

* J AT ADDRESS * 

* POINTR * 

* * 
****** •••*******« 



TRY TO 
START I/O * 
OPERATION 
************ 



* C2 * 
**** 



»»»**c2 ******* 

* * 

* SET 
.* POINTR = 

* DEVCHN(J) 

* * 
************** 



REMOVE UCB X 

*****C4*********4 
* WORD AT < 

* ADDR • DEVCHN(J)* 
. ..X* TO WORD AT * 
X * ADDRESS POINTR < 



NOT SENSE 



CHANNEL END 



*.THIS WORD 



* SET POINTR IN* 

. X*WORD AT ADDRESS* 

* IOQEND(K) * 

************** 



**** # 

► * • 
» El *.X. 

► * . 
**** X 

# * 

El 



t********** 



(PATH .* * 
BUSY) .* SENSE 
...*. ACCEPTED 



(*** 



PATH BUSY 



* C2 * 

* * 
**** 



***««E4*** 

* * 

* SET WORD AT * 

* ADDRESS * 

* DEVCHN(J) TO * 

* ZERO * 
************** 



SET RETURN 
ADDRESS = 
EXCRET 



*NO 

(OPERATION 
TERMINATED) 



*»*»*G3»****** 

* * 

* SET RETURN 

* ADDRESS = 

* NRMRET 

************** 



**** 

* * 

* C2 * 

* * 
• **• 



••***J2*****«* 



»«****«•**«** 



*»***K2 ******* 

* * 

* * 
*SET UNSTSW '0N«*. 



*••**•**•**•** x 

**•• 



* C4 
* 

**** 
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Chart FF. Overall Logic of IOPACK 



***** 

*FF * 
* A3* 
* * 



* ENTRY ROUTINE 
* 

**************** 



NOCSVC IB) 



X 

«****C 3** ******** 

•INITIALIZATION * 

* GENERAL * 
•INITIALIZATION * 

* ROUTINE * 
***************** 



X 
• *• 

D2 *• 
.* ARE *. 
NO .* INPUT *. 
..*. PARAMETERS .* 
♦CONSISTENT.* 



X 

*»***D3** ******** 
•INITIALIZATION * 

• ONE BLOCK * 

• FOR EACH I/O * 

• OPERATION * 
***************** 



SEND I/O 
REQUEST TO 
CONTPR 



••***G1 ******* 

* * 

* SET ERROR 

* RETURN 

* INDICATION 

* « 
************** 



****«G2 ******* 

* * 

* UPDATE 

* IOPACK 

* DICTIONARY 

* * 
************** 



******F 3****» ****** 

* * 

CONTPR 



UNUSUAL END 



****G5 ********* 
» • 
» WAIT * 

* * 

****«*»*••***•* 



* ROUTINE TO 
» ANALYZE CSW + 
» SENSE BYTES 
»*** *********** 



»** ONE BLOCK FOR 

* EACH I/O 
»-* OPERATION 



* EXIT ROUTINE * 

* * 
***************** 
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Chart FG. Overall Logic of INIT 




INIT X 

*****B1********** 

♦INITIAL ROUTINE* 
•SAVE DATA FROM » 
•ABSOLUTE LOADER* 
* # 
***************** 



****»C1 ********** 

•initialize i/o * 

* routine for * 
*1052 typewriter* 

* and ctl card * 

* input device * 



»**D1* 



***** 



READ A CONTROL 
•CARD AND PRINT 

CONTENTS ON 
* 1052 * 

TYPEWRI TER 



CRDAN X 

*****E1********** 

* ANALYZE CARD * 

* AND BUILD * 

* OBJECT CARD * 

* IMAGE * 

* * 
***************** 



VALID 
CARD 



DEV 360 
CARD 



DEVSUP 
CARD 



»***F 3* ******** 
MERGE OBJECT 

CARD IMAGE 
WITH ELEMENTS 
IN FIRST PART 
OF TABLE 
****** ********* 



****G3 ******** 

STORE OBJECT 
CARD IMAGE 

IN TABLE 
( 2ND PART) 

************** 



CALLPR 

*****H3********** 
* SAVE NAME OF * 
». YES 'PROGRAM CALLED * 

.* .X*SET UP I/O PACK*. 

* * TO INITIALIZE * 

♦PROGRAM CALLED * 
***************** 



CTLBL 

*****H4********** 

* PROCESS TABLE * 
*(1ST P ART ) BUI LD* 

. ..X*CHANNEL + UNIT * 
♦CONTROL BLOCKS * 

♦ ADJUST LOCCTR * 
***************** 



*****J3********** 

* GET • SYSTEM * 
♦SUPPORT DEVICE'* 

* READY TO LOAD *X 

* PROGRAM * 

* CALLED * 



IOPACK X 

*****J4********** 

* PROCESS TABLE * 

* ( 2ND PART). * 
...♦INITIALIZE I/O * 

•SUPPORT PACKAGE* 

* PROGRAM. * 



****K2 ********* 

* * 
.X* ERROR WAIT * 

* * 
*************** 



K3 *. 
.* HAS *. 
YES .* ANY *. h 

. . ..*. UNRECOVERABLE.*. 
♦ERROR BEEN.* 
♦.FOUND.* 



*****K4********** 

* SAVE ADDRESS * 

* OF DATA FOR * 
. X*RELOCAT. LOADER* 

* IN PARAMETER * 

* LIST REGISTER * 
***************** 
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Chart FH. Overall Logic of RELLDR 



LENTRY 

**«««A2*******«* 

* INITIALIZATION 
» RTN- SET UP 

. ..X* FOR PROGRAM 

* INTERRUPTION 

* SET CONSTANTS 
»«**#•* ****«*•*« 



RESENT 

***««A3«******«** 

* INITIALIZE » 

* SWITCHES TO * 
...X* PROCESS THE *. 

* NEXT » 

* MODULE * 
**********#****** 



LDCARD 

*****A4********* 

•GET CARD IMAGE 

* ROUTINE 
...X* GET LOADER 

• INPUT 



»**« 



*♦»•**** 



• ••*• 

*E A » 

• Bl* 



WHICH 
PROGRAM 
LOADED 



••*** 

•CA » 
* B2» 



SET LOCATION 
COUNTER 



► ##*#C5 ********** 

•RESERVE STORAGE* 
* FOR C.S. AND * 
» PLACE NAME * 



DICTIONARY 



******* 



n-BUILD UP DICT. 
» AND REF TAB. 
►WITH C.S. NAME 
* ENTRIES AND 
» EXTERNALS 
**************** 



****E5******** 

RELOCATE 
ASSEMBLY 
ADDRESS AND 
PLACE TEXT I Is 
STORAGE 



»**F5*****< 

CONVERT T 
TXT CARD 



END IN WAIT STATE 



****«G2 ♦»****••*• 

• PRODUCE • 

• 2 IPL CARDS * 
.* N TXT CARDS » 

• I END CARD * 

• • 
*••*•*•******••*« 



***#G5 ********* 

EVALUATE LOAD 
CONSTANTS OR 
PLACE IN 
RELOCATION 
LIST 
*************** 



•••••HI •**•••*••• 

* PRODUCE * 

* 1 IPL RECORD * 

* 1 PROGRAM *> 

* RECORD * 



*»»»#»»**« 



»***«■* 



OUTPUT 
. DEVICE 
*.TYPE . 



*****H3********** 

•CLEAR REF TABLE* 
•PROCESS RELOC. * 

* LIST SAVE *X 
•FIRST TRANSFER » 

* ADDRESS FOUND * 
****••****•••**•* 



•* INITIA- *. 
. LIZATION .*X. 
••REQUESTED.* 



ERROR *. 
FOUND .*X. 
. DURING .* 
•LOADING* 



*»***J3*»*****»»* 

* PLACE LOT OR * 

* END CARD * 
.* TRANSFER *X 

* ADDRESS IN * 

* INITIAL PSW • 
••**«*******•**•• 



*»»»K1 ********* 
* LOAD * 

» INITIAL PSW *. 
» • 

••••••••*•••••* 



• ••• 
* * 
.X* C2 * 
» • 
**•* 



»***K4** •****•• 

ERROR WAIT * 
* 

*************** 
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APPENDIX. LIST OF SIM20 ROUTINES 



The following list contains the symbolic 
names and functions of all major SIM20 
routines. 



FIXDIV Divides P and Q fields in 1620 
divide and floating divide opera- 
tions 



Basic and Console Simulation Routines 



INDAD 



Processes indirect addresses 



ALARM 



BIR 



EXCRET 



MASK 



MESSAG 



OUTIN 



Issues alarm commands on 
Printer-Keyboard 



the 1052 



Basic Interpretive Routine: decodes 
the operation codes of 1620 
instructions 

Selects exceptional returns from 
all I/O requests 

Builds up all code conversion 
tables required by I/O operations 

Processes all output messages on 
the 1052 Printer-Keyboard 

Selects the sequence corresponding 
to any 1620 I/O instruction and, in 
the case of the disk-resident ver- 
sion, checks its presence in core 
storage 



TYPIO 
VALIN 



CPU Simulation Routines 

ARCHK Processes arithmetic overflow and 
underflow 

COMP Compares P and Q fields in 1620 add 
and subtract and floating add and 
subtract operations 

CONVP Converts the P address only 

CONVPQ Converts both P and Q addresses 

CONVQ Converts the Q address only 

EXCHK Processes exponent overflow and 
underflow 

EXPOW Checks for exponent overflow and 
underflow 

FIXADD Adds or subtracts P and Q fields in 
1620 add and subtract and floating 
add and subtract operations 



INDEX Processes address indexing (1620 
Model 2) 

INDIC Updates HP/EZ indicators after all 
arithmetic operations 

MULT Multiplies P and Q fields in 1620 
multiply and floating multiply 
operations 

SHIFT Shifts P or Q fields, when the P 
and Q exponents are different, in 
1620 floating add and subtract 
operations 



I/O Simulation Routines 



GETEOR Scans the P field to detect a 
record mark in output operations 



Processes all physical I/O requests VALOUT 

Performs code conversion and valid- 
ity checking in all input opera- 
tions 



Performs code conversion and valid- 
ity checking in all output opera- 
tions 



Disk Simulation Routines 



CONVCW Converts the 1620 disk control 
field into data consistent with 
System/360 commands 

DCFADD Checks the sequence of sector 
addresses and updates the counter 

DISKER Handles all exceptional returns 
from I/O request and wait in read 
and check operations 

DISKEW Handles all exceptional returns 
from I/O request and wait in write 
operations 

DISRMH Prepares data for the MATCH subrou- 
tine 

ENDISK Detects the end of a disk operation 
by checking the sector count 
against zero 

IORW Processes all physical read and 
write operations on disk 
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MATCH Checks all sector addresses submit- 
ted against the contents of the 
21st sector 



READ21 Reads the 21st sector in core stor- 
age for the MATCH subroutine 

TESTGM Scans data to detect group marks 

TRAKED Performs all checks and counts in 
track mode operations 

WLRCSB Tests for a group mark after the 
last sector in operations with WLRC 



ABSLOD Routines (Module A21) 

GETCRD Analyzes loader cards 

IPLCTL Loads ABSLOD into System/360 main 
storage 

LDREAD Reads from tape or cards 

LENEND Processes END cards 

LENLDR Processes LDR cards 

LENLDT Processes LDT cards 

LENREP Processes REP cards 

LENTRY Initialization routine 

LENTXT Processes TXT cards 

LHEXB1 Converts hexadecimal to binary 

CONTPR Routines (Module A22) 



COMAND Reads commands from the 1052 
Printer-Keyboard 

INTUCB Determines the device index J of a 
unit control block and the channel 
index K of a channel control block, 
given the device address 

IOCONT Processes I/O request and continue 
calling sequences 

IOINT Processes I/O interruptions 

IOWAIT Processes I/O request and wait 
calling sequences 

MESAGE Transmits messages to the 1052 
Printer-Keyboard 

SENSE Performs sense operations 

SEREP Sets up the standard SEREP inter- 
face for I/O failures 



STACK Chains I/O request and continue 
calling sequences 

STRTIO Performs physical I/O operations 

SVCINT Processes SVC interruptions 

UNSTAK Initiates as many I/O operations as 
possible on a designated channel 
chain 

VERIFY Verifies the type and charac- 
teristics of a device 

IOPACK Routines (Module A23) 



CALLA 

CONSLE 

CVRTM 
INF ACT 

IOPACK 
NRMRET 



PN1442/ 
PN2540 

PRNT 

RD1442/ 
RD2540 

STRTIO 



Processes I/O request calling 
sequences 

Transmits messages to the 1052 
Printer-Keyboard 

Converts binary to hexadecimal 

Calls the write routine for IOPACK 
messages 

I/O support package entry routine 

Sets up exits for I/O request call- 
ing sequences 



Punches cards 
Printer output 



Reads cards 

Initializes I/O request 
sequences 



calling 



SWEXT Processes input commands 



TP 7 OP/ 

TAPERD/ 

TAPEWR 

TYPRD 

TYPWRT 



Reads or writes magnetic tapes 
Reads operator commands 
Writes operator messages 



INIT Routines (Module A2H) 

CALLPR Processes CALL cards 

CRDAN Analyzes control cards 

CTLBL Builds channel and unit control 
blocks 

CTLPR/ 

DEVPR Stores control information table 
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GETCRD Reads control cards 



INIT 



Initialization routine 



IOPACK Creates SYNTAB in the I/O support 
package 

LOCATE Exit routine 

LOCERR Prints error messages 

MSDG Writes messages 

RELLDR Routines (Module A25) 



LDCARD Reads card image 

LDEDIT Self-Loading Program Generator rou- 
tine 



LDEND Processes END cards 

LDESD Processes ESD cards 

LDICS Processes ICS cards 

LDLDT Processes LDT cards 
LDMSDG/ 

LPRINT Prints loading messages 

LDREP Processes REP cards 

LDRIN Loader initialization routine 

LDRLD Processes RLD cards 

LDSLC Processes SLC cards 

LDSWT Analyzes loader cards 

LDTXT Processes TXT cards 
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INDEX 



Where more than one reference is given, 
the first page number indicates the major 
reference. 



Absolute loader 7 

Allocation, System/360 main 

storage 7,8,9,10,11 

Assignment, System/360 device .... 64,65,67 

Basic Interpretive Routine 17,18 

BIR 17,18 

Buffer 21,44,63 

Buffer length 21 

CCB 20,41,67 

CCW 56,64,74,77 

Channel 

Multiplexor 20 

Selector 20 

Channel control check 61 

Channel data check 61 

Channel end 57,58,59,60,64 

Channel status information 58,57 

Channel Status Word 58 

Character 

Alphameric 15,16 

Numeric 15,16 

Special 15,16 

Chart (Reference) 

Chart AA 7 

Chart AB 8 

Chart AC 9 

Chart BA 17,18,21,25 

Chart BB 18 

Chart BC 19 

Chart BD 19 

Chart BE 19 

Chart BF 21 

Chart BG 22,21 

Chart BH 22,21 

Chart BK 25 

Chart BL 25 

Chart BM 23 

Chart BN 24 

Chart BP 23 

Chart BQ 23 

Chart BR 23 

Chart CA 41 

Chart CB 41 

Chart DA 44 

Chart EA 46 

Chart FA 50 

Chart FB 53 

Chart FC 59 

Chart FD 59 

Chart FE 61 

Chart FF 64 

Chart FG 67 

Chart Ffl 69 

CHTABL 21 



Command 44,61,62,63,64,67 

Console simulation 34,24 

Control alarm 62,63 

Control block 

Channel 20,68 

Unit 20,66,68,69 

Control card 

CALL ................ 7,66, 67 ,68,76 ,77,78 

CPU1 41 

CPU2 41 

DEVICE 41 

DEVSUP 7,67,68,69,78 

DEV360 7,67,68,69 

FEATURE 41 

MOD IF 46,47 

RIS mode C 46,47 

RIS mode R 46,47,48 

START * 41 

UPDATE 46,47 

Control program 53, 7 

Conversion 

Address 27,18 

Code 19 

P-address 18 

Q-address 18 

Core storage, 1620 15 

CPU simulation 15,18 

Device end 58,63,64 

Disk 

Address 23 

Check operation 40,23 

Control field 24 

Read operation 38,23 

Seek operation 37,24 

Write operation 39,23 

DSKINT 44,7,9,10,11 

Dump, System/360 64,66 

EDITOR 41,7,11 

ESD type term 71,72,69,76,77 

ESD type 1 term 72,73,69,71,76 

ESD type 2 term 73,69,71 

Exceptional condition 22,58 

Field 15,16,19 

Flag 15,19,67,68 

Format, load card 50 

Index Register 17,15,18 

Band 1 17 

Band 2 , 17 

Indicator 

Address check 23 

Indicator 19 24 

Indicator 39 24 

WLRC/RBC 23 

INIT=nnnnnn 68,77 

Initialization program 67,7 

Interface control check 61 

Interruption 

Attention 61,62,63,67 
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Code 54 

Disable 55,57,58,62,63 

Enable 55,54,63,64 

External 55,54,57,58,63,64 

I/O 59,60 

Machine- check 54,53 

Program 53,54,55 

SIM20 63 

Supervisor-call 54,53 

Intervention, operator 22,25 

I/O support package 64,7 

IPL 7,8,9,44,77 



Key 



Automatic Load 24 

Interrupt 55 

Start, 1620 17,24 

Stop, 1620 17,24 



LIST 

Loader card 

END 51,52,75,50,53,69,71 

ICS 70,71,69 

LDR 

LDT 52,53,75,76 

REP 51,74,75 

RLD 74 

SLC 70 

TXT 51,73,50,69,71 

Loading 

Absolute 50 

Selective 

Location counter 50,67,68, 

72,76 

Logic, Overall 

ABSLOD 

CONTPR 

DSKINT 

EDITOR 42,43 

INIT 

IOPACK 

I/O simulation 

Key simulation 

RELLDR 

Simulator 

SIM20 

UPDT20 

Logical I/O operation 66 



67,78 

,76,77 
,75,77 
52,50 
,69,77 
,50,69 
,69,71 
,69,77 
,74,77 

,76,77 
67,77 
69,70, 
,77,78 



... 80 
. .. 81 

45,44 
,12,41 
... 86 
... 85 
. .. 21 

24,35 
. .. 87 
. 12,7 

13,14 

12,49 
,64,65 



Machine check 53,54,68 

Message 69,61,62,63,64,70,71, 

75,76,77,78,79 

Mode, 1620 

Automatic 18,24,25 

Manual 24,18,25 

Parity- check bit 15 

PROGNAME card 68 

Program check 53,58,59,68,76 

Protection check 58 

Protection flag 23 

PSW 53,54,55,57,58,60,61,63,64,76,78 

PUNCH 68 

Read operation 32,21,23 

Record 16 

Register, SIM20 

MAPORG 17,18 



RP 16,17 

RQ 16,17 

Rl 17,18,19 

R2 17 

SIMB1 17 

SIMB2 17 

SIZE 17,18 

WR1 17 

WR2 17 

WR3 17 

WR4 17 

WR5 17 

WR6 17 

Register, 1620 

CR-1 17 

Digit and Branch 17 

IR-1 17 

IR-2 17 

IR-3 17 

IR-4 17 

MAR 17 

MBR 17 

MDR 17 

Multiplier-Quotient 17 

OP 17 

OR-1 17 

OR- 2 17 

OR- 3 17 

OR- 4 17 

OR- 5 17 

PR-1 17 

PR- 2 17 

PR-3 17 

Relocating loader 69,7 

Request, I/O 

Chaining I/O requests 60,59 

I/O request and continue .... 57,56,82,83 
I/O request and interrupt 

at channel end 57,55,60 

I/O request and wait 58,55,57,60 

Rewind 63,64 

Rewind and unload 63,64 

Sample program 11 

Sector 

Address 23 

Arrangement of 22 

Sector mode operations 23 

Self- Loading Program Generator 
routine 77,67,68,76 

Sense byte 57,58,59 

Sense operation 60,61 

Sequence 

ALARM 25 

DNTY 25 

INSERT 25 

RATY 25 

RNTY 25 

WATY 25 

WNTY 25 

SEREP interface 61,62,63,66 

Simulation routine 

Disk 22 

I/O, non-disk 21 

Simulator 7 

SIM20 15,7,8,11,44 

SIM20, disk resident 
version 21,9,10,14,44 
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Special features byte 55,56 

State 

Available 60 

Busy 60,57 

Chained 60,57 

Wait 64,54,67,75,77 

Subprogram 

ABSLOD 50,7,8,11 

CONTPR 53,7,8,11,50 

INIT 67,7,8,11,50 

IOPACK 64,7,8,10,11,50 

RELLDR 69,7,8,11,50 

Subroutine 

Address conversion 18 

MASK 19 

MESS AG 25 

VALIN 22 

VALOUT 22 

Supervisor call 53,54 

SVC 55,54 

SVC 1 57,54,61 

SVC 2 57,54,59,61 

SVC 3 63,54 

SVC 4 62,54 

SVC 5 62,54 

SVC 6 54 

SVC 7 61,54 

SVC 8 55,54 

SVC 9 55,54 

SVC 10 55,54 

SVC 11 58,54 

SVC 12 64,54 

SVC 13 63,54,61 

SVC 14 63,54,61 

SVC 15 63,54 

SVC 16 63,54 

SVC 17 64,65,54 

SVC 18 66,54,64 

SVC 19 64,54 

Switch 

Disk Check 24 



I/O check 24 

Overflow 24 

Paper tape 24 

Parity check 24 

Program 24 

Write address 23 

SYSINEND 11,68 

System control panel 24 

System tape 11 

Table 

Channel 21 

Code conversion 19 

Dictionary 70,69,72,74,75 

Operation code 19 

Reference 70,72,74,75 

Relocation List 70,74,75 

TABLE 67,68 

Tape mark 11,46,66 

Track mode operation 23 

Type, I/O device 55,56 

UCB 20,41,67 

Unit check 22,57,58,59,61,64 

Unit exception 22,58,64,66 

Unrecoverable error 22 

Updating function 

Insert 46,47,48 

Re-number 46,47,48 

Replace 46,47,48 

Suppress 46,47,48 

UPDTCORR 46,47 

UPDTNEW 46,47 

UPDTOLD 46,47 

UPDT20 46,7,10,11,12 

Verification, I/O device 55,56 

Write operation 33,22,23 
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